MCP エキスパート サーバー

Claude AIを活用したインテリジェントなクエリ生成とドキュメント作成支援を提供するモデルコンテキストプロトコルサーバーです。このサーバーはAPIドキュメントを分析し、以下の2つの主要ツールを提供します。

• create-query : 自然言語リクエストに基づいてクエリを生成する

• ドキュメント: 質問に基づいて関連するドキュメント情報を提供します

前提条件

• Node.js >= 18

• クロードのAnthropic APIキー

Related MCP server: MCP Outline Server

インストール

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 : クロードのメインシステムプロンプト

   • tool-metadata.txt : ツールの説明のための追加コンテキスト

   • query-metadata.txt : クエリ生成のための追加コンテキスト

   • service-description.txt : 自動生成されたサービスの説明

使用法

スタンドアロンサーバー

サーバーを起動します。

npm start

サーバーは、モデル コンテキスト プロトコルを介して 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?"
    }
  }

クロードデスクトップ統合

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クラスによって処理されます

• デバッグログは[DEBUG]プレフィックス付きでstderrに書き込まれます。

トラブルシューティング

接続の問題が発生した場合:

1. セットアップ スクリプトを実行したことを確認します。

npm run setup

2. prompts/ディレクトリに必要なファイルがすべて存在することを確認します

3. ANTHROPIC_API_KEYが正しく設定されていることを確認してください

4. Claude Desktop の設定で絶対パスを使用する

5. デバッグログ（stderrに書き込まれる）を確認する

環境変数

• ANTHROPIC_API_KEY : Anthropic APIキー（必須）

ライセンス

マサチューセッツ工科大学