MCP エキスパート サーバー
Claude AIを活用したインテリジェントなクエリ生成とドキュメント作成支援を提供するモデルコンテキストプロトコルサーバーです。このサーバーはAPIドキュメントを分析し、以下の2つの主要ツールを提供します。
- create-query : 自然言語リクエストに基づいてクエリを生成する
- ドキュメント: 質問に基づいて関連するドキュメント情報を提供します
前提条件
- Node.js >= 18
- クロードのAnthropic APIキー
インストール
- リポジトリをクローンする
- 依存関係をインストールします:
- Anthropic API キーを使用して
.env
ファイルを作成します。
ANTHROPIC_API_KEY=your_api_key_here
設定
サーバーを実行する前に、次のことを行う必要があります。
- プロジェクトをビルドし、セットアップ スクリプトを実行します。
npm run build
npm run setup
これにより、次のようになります。
- 必要なディレクトリ(
docs/
とprompts/
)を作成します。 - デフォルトのプロンプトファイルを作成する
- 初期のサービス説明を生成する
- APIドキュメントファイルを
docs/
ディレクトリに追加します( .txt
、 .md
、 .json
ファイルをサポートします)。 - オプションで、
prompts/
ディレクトリ内のプロンプトをカスタマイズします。system-prompt.txt
: クロードのメインシステムプロンプトtool-metadata.txt
: ツールの説明のための追加コンテキストquery-metadata.txt
: クエリ生成のための追加コンテキストservice-description.txt
: 自動生成されたサービスの説明
使用法
スタンドアロンサーバー
サーバーを起動します。
サーバーは、モデル コンテキスト プロトコルを介して 2 つのツールを公開します。
- create-query : 自然言語リクエストに基づいてクエリを生成する
{
"name": "create-query",
"arguments": {
"request": "Find all users who signed up in the last week"
}
}
- ドキュメント: ドキュメントから情報を取得する
{
"name": "documentation",
"arguments": {
"request": "How do I authenticate API requests?"
}
}
クロードデスクトップ統合
- この構成を Claude Desktop 構成ファイルに追加します。
{
"mcpServers": {
"expert": {
"command": "node",
"args": ["/ABSOLUTE/PATH/TO/expert-server/build/index.js"],
"env": {
"ANTHROPIC_API_KEY": "your_api_key_here"
}
}
}
}
/ABSOLUTE/PATH/TO/expert-server
サーバーのインストールへの実際の絶対パスに置き換えます。- Claude Desktop を再起動します。
ディレクトリ構造
.
├── docs/ # Your API documentation files
├── prompts/ # System prompts and metadata
│ ├── system-prompt.txt # Main system prompt
│ ├── tool-metadata.txt # Tool description context
│ ├── query-metadata.txt # Query generation context
│ └── service-description.txt # Generated service description
├── src/ # Source code
│ ├── index.ts # Entry point
│ ├── server.ts # MCP server implementation
│ └── services/ # Core services
│ └── expertService.ts # Claude integration
└── package.json
発達
- サーバーはTypeScriptを使用し、モジュール型アーキテクチャを採用しています。
- ClaudeとのやりとりはすべてExpertServiceクラスによって処理されます
- デバッグログは[DEBUG]プレフィックス付きでstderrに書き込まれます。
トラブルシューティング
接続の問題が発生した場合:
- セットアップ スクリプトを実行したことを確認します。
prompts/
ディレクトリに必要なファイルがすべて存在することを確認しますANTHROPIC_API_KEY
が正しく設定されていることを確認してください- Claude Desktop の設定で絶対パスを使用する
- デバッグログ(stderrに書き込まれる)を確認する
環境変数
ANTHROPIC_API_KEY
: Anthropic APIキー(必須)
ライセンス
マサチューセッツ工科大学