Prem MCP Server

Prem MCP Server

Prem AI 向けの Model Context Protocol（MCP）サーバー実装です。Claude やその他の MCP 対応クライアントとのシームレスな連携を可能にします。このサーバーは、MCP インターフェースを通じて Prem AI の強力な機能を利用できるようにします。

機能

• 🤖 チャット補完：Prem AI の言語モデルと対話できます
• 📚 RAG サポート：ドキュメントリポジトリとの連携による検索拡張生成
• 📝 ドキュメント管理：リポジトリ内のドキュメントをアップロードして管理できます
• 🎭 テンプレートシステム：用途に応じた出力に、あらかじめ定義されたプロンプトテンプレートを使用できます
• ⚡ ストリーミング応答：モデルの出力をリアルタイムでストリーミングします
• 🛡️ エラー処理：堅牢なエラー処理とログ記録

前提条件

• Node.js（v16 以上）
• API キーを持つ Prem AI アカウント
• Prem プロジェクト ID

インストール

Smithery 経由でのインストール

Smithery を使って Claude Desktop 用の prem-mcp-server を自動的にインストールするには：

npx -y @smithery/cli install @ucalyptus/prem-mcp-server --client claude

手動でのインストール

# Using npm
npm install prem-mcp-server

# Using yarn
yarn add prem-mcp-server

# Using pnpm
pnpm add prem-mcp-server

設定

1. 環境変数

プロジェクトのルートに .env ファイルを作成します：

PREM_API_KEY=your_api_key_here
PREM_PROJECT_ID=your_project_id_here

2. Cursor の設定

Prem MCP サーバーを Cursor で使用するには、以下を ~/.cursor/mcp.json に追加します：

{
  "mcpServers": {
    "PremAI": {
      "command": "node",
      "args": ["/path/to/your/prem-mcp/build/index.js", "--stdio"],
      "env": {
        "PREM_API_KEY": "your_api_key_here",
        "PREM_PROJECT_ID": "your_project_id_here"
      }
    }
  }
}

/path/to/your/prem-mcp をプロジェクトディレクトリの実際のパスに置き換えてください。

3. Claude Desktop の設定

Claude Desktop ユーザーは、以下を claude_desktop_config.json に追加します：

{
  "mcpServers": {
    "PremAI": {
      "command": "npx",
      "args": ["prem-mcp-server", "--stdio"],
      "env": {
        "PREM_API_KEY": "your_api_key_here",
        "PREM_PROJECT_ID": "your_project_id_here"
      }
    }
  }
}

使用方法

サーバーの起動

npx prem-mcp-server

プロンプトの例

1. 基本的なチャット

Let's have a conversation about artificial intelligence.

2. ドキュメントを使った RAG

Based on the documents in repository XYZ, what are the key points about [topic]?

3. テンプレートの使用

Use template ABC to generate [specific type of content].

ドキュメントのアップロード

このサーバーは、RAG 操作のために Prem AI リポジトリへのドキュメントのアップロードをサポートしています。対応形式：

• .txt
• .pdf
• .docx

API リファレンス

チャット補完のパラメーター

• query：入力テキスト
• system_prompt：カスタムシステムプロンプト
• model：モデル識別子
• temperature：応答のランダム性（0-1）
• max_tokens：応答の最大長
• repository_ids：RAG に使用するリポジトリ ID の配列
• similarity_threshold：ドキュメント類似度のしきい値
• limit：ドキュメントチャンクの最大数

テンプレートのパラメーター

• template_id：プロンプトテンプレートの ID
• params：テンプレート固有のパラメーター
• temperature：応答のランダム性（0-1）
• max_tokens：応答の最大長

開発

# Clone the repository
git clone https://github.com/yourusername/prem-mcp-server.git

# Install dependencies
npm install

# Build the project
npm run build

# Run tests
npm test

トラブルシューティング

よくある問題

1. サーバーが見つからない

   • claude_desktop_config.json 内のサーバーパスを確認してください
   • サーバーが起動しているか確認してください

2. API キーが無効

   • Prem AI API キーが有効であることを確認してください
   • API キーに必要な権限があるか確認してください

3. ドキュメントのアップロードに失敗

   • ファイル形式が対応しているか確認してください
   • ファイルのアクセス許可を確認してください
   • リポジトリ ID が正しいことを確認してください

貢献

貢献を歓迎します。お気軽にプルリクエストを送信してください。

ライセンス

MIT ライセンスの詳細については、LICENSE ファイルを参照してください。

謝辞

• 強力な AI プラットフォームを提供する Prem AI
• プロトコル仕様を提供する Model Context Protocol
• Claude と MCP エコシステムを提供する Anthropic

サポート

問題や機能リクエストについては、GitHub Issues ページをご利用ください。