Baryhuang MCP Server Any Openapi

🚀 MCP サーバー

MCP サーバーは FastAPI ベースのサービスで、Claude Desktop と統合された MCP プロトコルをサポートし、自然言語処理による API の理解と呼び出し機能を提供します。このサーバーは OpenAPI 仕様を解析し、セマンティックインデックスを生成し、ユーザーの自然言語クエリに基づいて適切な API エンドポイントを推薦します。

✨ 主な機能

• OpenAPI 解析：標準の OpenAPI 3.x 仕様を解析でき、数千のエンドポイントを含む大規模な仕様ファイルも処理可能です。
• セマンティック検索：最適化された埋め込みモデル（sentence-transformers など）を利用し、各 API エンドポイントにセマンティック表現を生成し、ユーザーの自然言語クエリにマッチングします。
• 自動推薦：セマンティック類似度に基づき、最も関連する API エンドポイント、リクエストメソッド、パラメータ情報を推薦します。
• ドキュメント生成：パス、メソッド、パラメータ、レスポンス形式などの詳細情報を含む構造化された API ドキュメントを自動生成できます。

📦 インストール

事前構築済みイメージの使用

docker pull buryhuang/mcp-server-any-openapi:latest

ローカル開発用のビルド

docker build -t mcp-server-any-openapi .

コンテナの起動

docker run \
  -e OPENAPI_JSON_DOCS_URL=https://api.example.com/openapi.json \
  -e MCP_API_PREFIX=finance \
  buryhuang/mcp-server-any-openapi:latest

🔧 技術詳細

主要コンポーネント

1. EndpointSearcher：コアクラスで、以下の機能を担当します。
   • OpenAPI 仕様の解析
   • セマンティック検索インデックスの作成
   • エンドポイントドキュメントの整形
   • 自然言語クエリの処理
2. サーバー実装：
   • 非同期 FastAPI サーバー
   • MCP プロトコルのサポート
   • ツールの登録と呼び出し処理

統合と設定

Claude Desktop で MCP サーバーを設定するには、以下のようにします。

{
  "mcpServers": {
    "any_openapi": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "OPENAPI_JSON_DOCS_URL=https://api.example.com/openapi.json",
        "-e",
        "MCP_API_PREFIX=finance",
        "buryhuang/mcp-server-any-openapi:latest"
      ]
    }
  }
}

貢献ガイド

1. リポジトリをフォークします。
2. 機能ブランチを作成します（git checkout -b feature/amazing-feature）。
3. 変更をコミットします（git commit -m 'Add some amazing feature'）。
4. ブランチにプッシュします（git push origin feature/amazing-feature）。
5. Pull Request を作成します。

📄 ライセンス

このプロジェクトは LICENSE ファイルの条項に基づいてライセンスされています。

実装に関する説明

• エンドポイントベースの処理：ドキュメント全体の分析ではなく、以下の方法で各エンドポイントに一意の識別子を生成します。
  • パス + メソッド
  • パラメータ感知埋め込み
  • レスポンスモードのコンテキスト
• 最適化された仕様処理：以下の方法で OpenAPI 仕様を処理します（最大 10MB、約 5,000 個のエンドポイントをサポート）。
  • 遅延ロード方式のコンポーネント
  • 並列パス項目解析
  • 冗長な説明を無視した選択的な埋め込み生成