MCP Expert Server

🚀 MCPエキスパートサーバー

このサーバーは、モデルコンテキストプロトコル（Model Context Protocol）を利用し、Claude AIを通じて、インテリジェントなクエリ生成とドキュメント支援機能を提供します。サーバーはあなたのAPIドキュメントを解析し、以下の2つの主要なツールを提供します。

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

🚀 クイックスタート

✨ 主な機能

このサーバーは、モデルコンテキストプロトコル（Model Context Protocol）を利用し、Claude AIを通じて、インテリジェントなクエリ生成とドキュメント支援機能を提供します。具体的には、以下の2つの主要なツールを提供します。

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

📦 インストール

前提条件

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

インストール手順

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

npm install

3. .envファイルを作成し、Anthropic APIキーを追加します。

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

このサーバーは、モデルコンテキストプロトコル（MCP）を通じて2つのツールを提供します。

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

{
    "name": "create-query",
    "arguments": {
        "request": "過去1週間に登録されたすべてのユーザーを検索する"
    }
}

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

{
    "name": "documentation",
    "arguments": {
        "request": "APIリクエストの認証方法は？"
    }
}

Claudeデスクトップ統合

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/                  # あなたのAPIドキュメントファイル
├── prompts/              # システムプロンプトとメタデータ
│   ├── system-prompt.txt    # 主要なシステムプロンプト
│   ├── tool-metadata.txt   # ツール説明の追加コンテキスト
│   ├── query-metadata.txt  # クエリ生成の追加コンテキスト
│   └── service-description.txt # 自動生成されたサービス説明
├── build/                # ビルド出力ディレクトリ（スクリプトによって作成）
└── package.json          # プロジェクトの依存関係とスクリプト設定

開発

• npm run devコマンドを使用して開発サーバーを起動します。
• すべてのコードはsrc/ディレクトリにあり、モジュール化された構造になっています。

トラブルシューティング

1. Node.jsのバージョンが >= 18であることを確認します。
2. .envファイル内のAPIキーが正しく設定されていることを確認します。
3. スクリプトを実行する前にすべての依存関係をインストールします。

npm install

環境変数

• ANTHROPIC_API_KEY：Anthropic APIのアクセスキー。

📄 ライセンス

MIT License