MCP Server Any Openapi

🚀 MCP サーバー

MCP（Message Communication Protocol）サーバーは、FastAPI をベースにしたプロトコル実装で、Claude Desktop とのインタラクションをサポートします。Docker で実行でき、複数のプラットフォームアーキテクチャをサポートしています。

✨ 主な機能

• 多アーキテクチャサポート：公式イメージは linux/amd64、linux/arm64 の3つのプラットフォームをサポートしています。
• 柔軟なツール命名：MCP_API_PREFIX を使用してツール名を制御できます。
• OpenAPI サポート：OpenAPI 仕様を処理し、API エンドポイント情報を抽出し、検索機能を提供します。

📦 インストール

事前構築済みイメージの使用（Docker Hub）

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

💻 使用例

基本的な使用法

Claude Desktop で MCP サーバーを設定するには、以下のように JSON ファイルを編集します。

{
  "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",
        "-e",
        "GLOBAL_TOOL_PROMPT='Access to insights apis for ACME Financial Services abc.com .",
        "buryhuang/mcp-server-any-openapi:latest"
      ]
    }
  }
}

🔧 技術詳細

コアコンポーネント

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

実装の特徴

• エンドポイントベースの処理：大規模なドキュメントを処理するのが難しいドキュメントベースの方法とは異なり、以下の方法でエンドポイントをインデックスします。
  • パスとメソッドを一意の識別子として使用
  • パラメーター感知埋め込み
  • レスポンススキームのコンテキスト
• 最適化された仕様処理：以下の方法で OpenAPI 仕様を処理します（最大 10MB または約 5,000 個のエンドポイントをサポート）。
  • 遅延ロードコンポーネントモード
  • パス項目の並列解析
  • 選択的な埋め込み生成（冗長な説明を省略）

🤝 貢献のガイドライン

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 ファイルに記載されています。