Crazyrabbitltc MCP Expert Server

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

このサーバーは、モデルコンテキストプロトコル（Model Context Protocol）を利用し、Claude AIを通じて、スマートなクエリ生成とドキュメントサポート機能を提供します。サーバーはAPIドキュメントを分析し、以下の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": "查找过去一周内注册的所有用户"
    }
}

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

{
    "name": "documentation",
    "arguments": {
        "request": "如何进行API请求认证？"
    }
}

Claudeデスクトップ統合

1. 以下の設定をClaudeデスクトップの設定ファイルに追加します。

{
    "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デスクトップを再起動します。

🔧 技術詳細

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

📚 ドキュメント

ディレクトリ構造

.
├── docs/                  # あなたのAPIドキュメントファイル
├── prompts/              # システムプロンプトとメタデータ
│   ├── system-prompt.txt    # 主要なシステムプロンプト
│   ├── tool-metadata.txt    # ツール説明のコンテキスト
│   ├── query-metadata.txt   # クエリ生成のコンテキスト
│   └── service-description.txt  # 生成されたサービス説明
├── src/                  # ソースコード
│   ├── index.ts            # エントリーポイント
│   ├── server.ts           # MCPサーバーの実装
│   └── services/           # コアサービス
│       └── expertService.ts  # Claude統合
└── package.json

トラブルシューティング

接続問題が発生した場合は、以下の手順を実行してください。

1. 設定スクリプトが実行されていることを確認します。

npm run setup

2. prompts/ディレクトリにすべての必須ファイルが存在することを確認します。
3. ANTHROPIC_API_KEYが正しく設定されていることを検証します。
4. Claudeデスクトップの設定で絶対パスを使用していることを確認します。
5. デバッグログを確認して詳細情報を取得します。

環境変数

• ANTHROPIC_API_KEY：ClaudeモデルにアクセスするためのAnthropic APIのキーです。

📄 ライセンス

このプロジェクトはMIT Licenseの下で保護されています。