Skip to main content
Glama
enesjakozh

MCP Server: Scalable OpenAPI Endpoint Discovery and API Request Tool

by baryhuang
OverviewSchemaRelated ServersScoreDiscussions
Python
Remote
MIT License
74

MCP サーバー: スケーラブルな OpenAPI エンドポイント検出および API リクエスト ツール

Dockerハブ ライセンス: MIT

やるべきこと

  • 事前ダウンロードしたモデルなしではDockerイメージは2GBです。事前ダウンロードしたモデルを含めると3.76GBになります！ 大きすぎるので、サイズを小さくするのを手伝ってください。

Related MCP server: OpenAPI MCP Server

構成

環境変数を通じてカスタマイズします。GLOBAL_TOOL_PROMPTは 重要です!

  • OPENAPI_JSON_DOCS_URL : OpenAPI 仕様 JSON への URL (デフォルトはhttps://api.staging.readymojo.com/openapi.json )

  • MCP_API_PREFIX : カスタマイズ可能なツール名前空間 (デフォルトは "any_openapi"):

    # Creates tools: custom_api_request_schema and custom_make_request docker run -e MCP_API_PREFIX=finance ...

  • GLOBAL_TOOL_PROMPT : すべてのツールの説明の先頭に追加するオプションのテキスト。これは、Claude がツールを正確に選択し、正しく選択されないために重要です。

    # Adds "Access to insights apis for ACME Financial Services abc.com . " to the beginning of all tool descriptions docker run -e GLOBAL_TOOL_PROMPT="Access to insights apis for ACME Financial Services abc.com ." ...

要約

これを作成した理由: Swagger OpenAPI ドキュメントのサイズが数百 KB のプライベート API を提供したいからです。

  • Claude MCPはこれらのファイルサイズを処理する際にエラーが発生します

  • 結果をYAMLに変換しようとしましたが、サイズが小さすぎ、エラーが多く発生しました。失敗しました。

  • APIカテゴリを指定して、MCPクライアント（Claude Desktop）にグループ別にAPIドキュメントを取得するよう依頼してみましたが、それでも大きすぎて失敗しました。

最終的に、私はこの解決策にたどり着きました:

  • メモリ内のセマンティック検索を使用して、自然言語で関連する API エンドポイントを検索します (製品のリストなど)

  • 完全なエンドポイントドキュメントを（1つのエンドポイントを1つのチャンクとして保存するように設計したため）100万秒以内に返します（メモリ内にあるため）。

なんと、Claude は完全なパラメータを使用してどの API を呼び出すべきかを知るようになりました。

待ってください。実際の RESTful リクエストを行うには、このサーバーに別のツールを作成する必要があります。「フェッチ」サーバーが単純に機能しないため、その理由をデバッグしたくないのです。

https://github.com/user-attachments/assets/484790d2-b5a7-475d-a64d-157e839ad9b0

技術的なハイライト:

query -> [Embedding] -> FAISS TopK -> OpenAPI docs -> MCP Client (Claude Desktop) MCP Client -> Construct OpenAPI Request -> Execute Request -> Return Response

特徴

  • 🧠 リモートの OpenAPI JSON ファイルをソースとして使用します。ローカル ファイル システムへのアクセスは不要で、API の変更に伴う更新は不要です。

  • 🔍 最適化された MiniLM-L3 モデルを使用したセマンティック検索 (43MB vs オリジナル 90MB)

  • 🚀 非同期サポートを備えたFastAPIベースのサーバー

  • 🧠 エンドポイントベースのチャンク化 OpenAPI 仕様 (100KB 以上のドキュメントを処理)、エンドポイントのコンテキストが失われない

  • ⚡ エンドポイントを瞬時に検出するインメモリ FAISS ベクトル検索

制限事項

  • linux/arm/v7 をサポートしていません (Transformer ライブラリでビルドが失敗します)

  • 🐢 Docker イメージを使用していない場合、コールド スタートのペナルティ (モデルの読み込みに約 15 秒)

  • [廃止] 現在のDockerイメージではモデルのダウンロードが無効になっています。huggingfaceに依存しています。Claude Desktopを読み込む際、モデルのダウンロードに時間がかかります。huggingfaceがダウンしている場合、サーバーは起動しません。

  • 最新のDockerイメージには、事前にダウンロードしたモデルが組み込まれています。問題がある場合は、古いものに戻してください。

マルチインスタンス構成の例

マルチインスタンス設定の例を以下に示します。複数のAPIセットをより柔軟に使用できるように設計しました。

{ "mcpServers": { "finance_openapi": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "OPENAPI_JSON_DOCS_URL=https://api.finance.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" ] }, "healthcare_openapi": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "OPENAPI_JSON_DOCS_URL=https://api.healthcare.com/openapi.json", "-e", "MCP_API_PREFIX=healthcare", "-e", "GLOBAL_TOOL_PROMPT='Access to insights apis for Healthcare API services efg.com .", "buryhuang/mcp-server-any-openapi:latest" ] } } }

この例では、

  • サーバーは OpenAPI ドキュメントからベース URL を自動的に抽出します。

    • 金融APIについてはhttps://api.finance.com

    • ヘルスケア API についてはhttps://api.healthcare.com

  • オプションで、 API_REQUEST_BASE_URL環境変数を使用してベース URL をオーバーライドできます。

{ "mcpServers": { "finance_openapi": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "OPENAPI_JSON_DOCS_URL=https://api.finance.com/openapi.json", "-e", "API_REQUEST_BASE_URL=https://api.finance.staging.com", "-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" ] } } }

クロードデスクトップの使用例

クロードデスクトッププロジェクトプロンプト:

You should get the api spec details from tools financial_api_request_schema You task is use financial_make_request tool to make the requests to get response. You should follow the api spec to add authorization header: Authorization: Bearer <xxxxxxxxx> Note: The base URL will be returned in the api_request_schema response, you don't need to specify it manually.

チャットでは次のことができます:

Get prices for all stocks

インストール

Smithery経由でインストール

Smithery経由で Claude Desktop 用のスケーラブルな OpenAPI エンドポイント検出と API リクエスト ツールを自動的にインストールするには:

npx -y @smithery/cli install @baryhuang/mcp-server-any-openapi --client claude

pipの使用

pip install mcp-server-any-openapi

利用可能なツール

サーバーは次のツールを提供します ( {prefix}はMCP_API_PREFIXによって決定されます)。

{プレフィックス}_api_request_schema

インテントに一致するAPIエンドポイントスキーマを取得します。パス、メソッド、パラメータ、レスポンス形式などのエンドポイントの詳細を返します。

入力スキーマ:

{ "query": { "type": "string", "description": "Describe what you want to do with the API (e.g., 'Get user profile information', 'Create a new job posting')" } }

{プレフィックス}_make_request

簡素化された実装では失敗する複雑な API で信頼性の高い実行を行うために不可欠です。以下を提供します。

入力スキーマ:

{ "method": { "type": "string", "description": "HTTP method (GET, POST, PUT, DELETE, PATCH)", "enum": ["GET", "POST", "PUT", "DELETE", "PATCH"] }, "url": { "type": "string", "description": "Fully qualified API URL (e.g., https://api.example.com/users/123)" }, "headers": { "type": "object", "description": "Request headers (optional)", "additionalProperties": { "type": "string" } }, "query_params": { "type": "object", "description": "Query parameters (optional)", "additionalProperties": { "type": "string" } }, "body": { "type": "object", "description": "Request body for POST, PUT, PATCH (optional)" } }

応答形式:

{ "status_code": 200, "headers": { "content-type": "application/json", ... }, "body": { // Response data } }

Docker サポート

マルチアーキテクチャビルド

公式イメージは 3 つのプラットフォームをサポートしています。

# Build and push using buildx docker buildx create --use docker buildx build --platform linux/amd64,linux/arm64 \ -t buryhuang/mcp-server-any-openapi:latest \ --push .

柔軟なツール命名

MCP_API_PREFIXを介してツール名を制御します。

# Produces tools with "finance_api" prefix: docker run -e MCP_API_PREFIX=finance_ ...

サポートされているプラットフォーム

  • Linux/amd64

  • Linux/arm64

オプション 1: ビルド済みイメージを使用する (Docker Hub)

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

オプション2: ローカル開発ビルド

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プロトコルのサポート

    • ツールの登録と呼び出しの処理

ソースから実行

python -m mcp_server_any_openapi

Claude Desktopとの統合

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", "-e", "GLOBAL_TOOL_PROMPT='Access to insights apis for ACME Financial Services abc.com .", "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. プルリクエストを開く

ライセンス

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

実装ノート

  • エンドポイント中心の処理: 大規模な仕様で苦労するドキュメント レベルの分析とは異なり、個々のエンドポイントを次のようにインデックスします。

    • パス + メソッドを一意の識別子として

    • パラメータを考慮した埋め込み

    • レスポンススキーマコンテキスト

  • 最適化された仕様処理: 最大 10 MB (約 5,000 エンドポイント) の OpenAPI 仕様を以下を通じて処理します。

    • スキーマコンポーネントの遅延読み込み

    • パス項目の並列解析

    • 選択的埋め込み生成（冗長な記述を省略）

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

How are these scores calculated?

Resources

Appeared in Searches

New MCP Servers

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/baryhuang/mcp-server-any-openapi'

If you have feedback or need assistance with the MCP directory API, please join our Discord server