MCP Expert Server

MCP Expert Server

Claude AI を使用して、インテリジェントなクエリ生成とドキュメント支援を提供する Model Context Protocol サーバーです。このサーバーは API ドキュメントを分析し、主に次の 2 つのツールを提供します。

• create-query：自然言語のリクエストに基づいてクエリを生成します
• documentation：質問に基づいて関連するドキュメント情報を提供します

前提条件

• Node.js >= 18
• Claude 用の Anthropic API キー

インストール

1. リポジトリをクローンします
2. 依存関係をインストールします：

npm install

3. Anthropic API キーを設定した .env ファイルを作成します：

ANTHROPIC_API_KEY=your_api_key_here

セットアップ

サーバーを実行する前に、次の作業が必要です。

1. プロジェクトをビルドし、セットアップスクリプトを実行します：

npm run build
npm run setup

これにより、次の処理が行われます。

• 必要なディレクトリ（docs/ と prompts/）を作成します
• デフォルトのプロンプトファイルを作成します
• 初期サービス説明を生成します

2. API ドキュメントファイルを docs/ ディレクトリに追加します（.txt、.md、.json ファイルに対応しています）

3. 必要に応じて、prompts/ ディレクトリ内のプロンプトをカスタマイズします。

   • system-prompt.txt：Claude 用のメインシステムプロンプト
   • tool-metadata.txt：ツールの説明に追加するコンテキスト
   • query-metadata.txt：クエリ生成に追加するコンテキスト
   • service-description.txt：自動生成されるサービス説明

使用方法

スタンドアロンサーバー

サーバーを起動します：

npm start

サーバーは Model Context Protocol を通じて 2 つのツールを公開します。

• create-query：自然言語のリクエストに基づいてクエリを生成します

  {
    "name": "create-query",
    "arguments": {
      "request": "Find all users who signed up in the last week"
    }
  }
  

• documentation：ドキュメントから情報を取得します

  {
    "name": "documentation",
    "arguments": {
      "request": "How do I authenticate API requests?"
    }
  }
  

Claude Desktop との連携

1. この設定を Claude Desktop の設定ファイルに追加します：

{
  "mcpServers": {
    "expert": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/expert-server/build/index.js"],
      "env": {
        "ANTHROPIC_API_KEY": "your_api_key_here"
      }
    }
  }
}

2. /ABSOLUTE/PATH/TO/expert-server を、サーバーをインストールした実際の絶対パスに置き換えます。

3. 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

開発

• プロジェクトをビルドします：

npm run build

• サーバーは TypeScript を使用し、モジュール式のアーキテクチャに従っています
• Claude とのやり取りはすべて ExpertService クラスが処理します
• デバッグログは stderr に [DEBUG] プレフィックス付きで書き込まれます

トラブルシューティング

接続の問題が発生した場合は、次の点を確認してください。

1. セットアップスクリプトを実行済みであることを確認します：

npm run setup

2. prompts/ ディレクトリに必要なファイルがすべて存在することを確認します
3. ANTHROPIC_API_KEY が正しく設定されていることを確認します
4. Claude Desktop の設定では絶対パスを使用します
5. デバッグログを確認します（stderr に書き込まれます）

環境変数

• ANTHROPIC_API_KEY：Anthropic API キー（必須）

ライセンス

MIT