mcp-openapi-proxy

mcp-openapi-proxyは、Model Context Protocol (MCP) サーバーを実装する Python パッケージです。OpenAPI 仕様で定義された REST API を MCP ツールとして動的に公開するように設計されています。これにより、OpenAPI で記述された API を MCP ベースのワークフローにシームレスに統合できます。

概要

このパッケージには 2 つの動作モードがあります。

低レベルモード (デフォルト): OpenAPI ドキュメントで指定されたすべての有効な API エンドポイントに対応するツールを動的に登録します (例: /chat/completions``chat_completions()になります)。
**FastMCP モード (シンプルモード):**静的構成に基づいて定義済みのツールセット ( list_functions()やcall_function()など) を公開することで、合理化されたアプローチを提供します。

特徴

動的ツール生成: OpenAPI エンドポイント定義から MCP ツールを自動的に作成します。
シンプルモードオプション: FastMCP モードを介して静的構成の代替手段を提供します。
OpenAPI 仕様のサポート: OpenAPI v3 と互換性があり、v2 もサポートされる可能性があります。
**柔軟なフィルタリング:**パスやその他の基準によるホワイトリストによるエンドポイントのフィルタリングを可能にします。
ペイロード認証: JMESPath 式によるカスタム認証をサポートします (例: HTTP ヘッダーではなくペイロード内のトークンを期待する Slack などの API の場合)。
ヘッダー認証: Authorization ヘッダーのAPI_KEYにはデフォルトでBearerを使用します。Api Api-Keyを必要とする Fly.io などの API に合わせてカスタマイズ可能です。
MCP 統合: REST API をツールとして呼び出すために MCP エコシステムとシームレスに統合します。

インストール

次のコマンドを使用して、PyPI からパッケージを直接インストールします。

uvx mcp-openapi-proxy

MCPエコシステム統合

mcp-openapi-proxy をMCPエコシステムに組み込むには、 mcpServers設定内で設定します。以下に一般的な例を示します。

{
    "mcpServers": {
        "mcp-openapi-proxy": {
            "command": "uvx",
            "args": ["mcp-openapi-proxy"],
            "env": {
                "OPENAPI_SPEC_URL": "${OPENAPI_SPEC_URL}",
                "API_KEY": "${API_OPENAPI_KEY}"
            }
        }
    }
}

特定の API に合わせた実際の構成については、以下の例のセクションを参照してください。

動作モード

FastMCPモード（シンプルモード）

**有効化方法:**環境変数OPENAPI_SIMPLE_MODE=trueを設定します。
**説明:**コードで定義されている特定の OpenAPI エンドポイントから派生した固定のツールセットを公開します。
**構成:**ツールの動作を指定するには環境変数に依存します。

低レベルモード（デフォルト）

**説明:**提供された OpenAPI 仕様からすべての有効な API エンドポイントを個別のツールとして自動的に登録します。
**ツールの命名:**正規化された OpenAPI パスとメソッドからツール名を派生します。
動作: OpenAPI 操作の概要と説明からツールの説明を生成します。

環境変数

OPENAPI_SPEC_URL : (必須) OpenAPI 仕様 JSON ファイルへの URL (例: https://example.com/spec.jsonまたはfile:///path/to/local/spec.json )。
OPENAPI_LOGFILE_PATH : (オプション) ログファイルのパスを指定します。
OPENAPI_SIMPLE_MODE : (オプション) FastMCP モードを有効にするにはtrueに設定します。
TOOL_WHITELIST : (オプション) ツールとして公開するエンドポイントパスのコンマ区切りリスト。
TOOL_NAME_PREFIX : (オプション) すべてのツール名の先頭に付けるプレフィックス。
API_KEY : (オプション) デフォルトでは Authorization ヘッダーでBearer <API_KEY>として送信される API の認証トークン。
API_AUTH_TYPE : (オプション) デフォルトのBearer Authorization ヘッダータイプ (GetZep の場合はApi-Keyなど) をオーバーライドします。
STRIP_PARAM : (オプション) 不要なパラメータを削除するための JMESPath 式 (例: Slack のtoken )。
DEBUG : (オプション) 「true」、「1」、または「yes」に設定すると、詳細なデバッグログが有効になります。
EXTRA_HEADERS : (オプション) 送信 API リクエストに添付する「ヘッダー: 値」形式の追加の HTTP ヘッダー (1 行に 1 つ)。
SERVER_URL_OVERRIDE : (オプション) 設定時に OpenAPI 仕様のベース URL をオーバーライドします。カスタム展開に役立ちます。
TOOL_NAME_MAX_LENGTH : (オプション) ツール名を最大長に切り捨てます。
追加変数: OPENAPI_SPEC_URL_<hash> – テストごとに固有の構成のバリアント ( OPENAPI_SPEC_URLにフォールバックします)。
IGNORE_SSL_SPEC : (オプション) OpenAPI 仕様を取得するときに SSL 証明書の検証を無効にするには、 trueに設定します。
IGNORE_SSL_TOOLS : (オプション) ツールによって行われた API リクエストの SSL 証明書検証を無効にするには、 trueに設定します。

例

テストとして、例に示されているようにuvxコマンドを実行し、JSON-RPCメッセージを介してMCPサーバーとやり取りしてツールとリソースを一覧表示することができます。以下の「JSON-RPCテスト」セクションをご覧ください。

Glamaの例

Glama は、 OPENAPI_SPEC_URL環境変数のみを必要とする、mcp-openapi-proxy の最小限の設定を提供します。このシンプルさは、迅速なテストに最適です。

1. OpenAPI仕様を確認する

Glama OpenAPI 仕様を取得します。

curl https://glama.ai/api/mcp/openapi.json

応答が有効な OpenAPI JSON ドキュメントであることを確認します。

2. Glama用にmcp-openapi-proxyを設定する

MCP エコシステム設定に次の構成を追加します。

{
    "mcpServers": {
        "glama": {
            "command": "uvx",
            "args": ["mcp-openapi-proxy"],
            "env": {
                "OPENAPI_SPEC_URL": "https://glama.ai/api/mcp/openapi.json"
            }
        }
    }
}

3. テスト

次のようにしてサービスを開始します。

OPENAPI_SPEC_URL="https://glama.ai/api/mcp/openapi.json" uvx mcp-openapi-proxy

次に、リソースとツールをリストする手順については、 JSON-RPC テストのセクションを参照してください。

Fly.ioの例

Fly.ioはマシン管理用のシンプルなAPIを提供しており、理想的な出発点となります。Fly.ioのドキュメントからAPIトークンを取得してください。

1. OpenAPI仕様を確認する

Fly.io OpenAPI 仕様を取得します。

curl https://raw.githubusercontent.com/abhiaagarwal/peristera/refs/heads/main/fly-machines-gen/fixed_spec.json

応答が有効な OpenAPI JSON ドキュメントであることを確認します。

2. Fly.io 用に mcp-openapi-proxy を設定する

MCP エコシステム構成を更新します。

{
    "mcpServers": {
        "flyio": {
            "command": "uvx",
            "args": ["mcp-openapi-proxy"],
            "env": {
                "OPENAPI_SPEC_URL": "https://raw.githubusercontent.com/abhiaagarwal/peristera/refs/heads/main/fly-machines-gen/fixed_spec.json",
                "API_KEY": "<your_flyio_token_here>"
            }
        }
    }
}

OPENAPI_SPEC_URL : Fly.io OpenAPI 仕様を指します。
API_KEY : Fly.io API トークン ( <your_flyio_token_here>を置き換えます)。
API_AUTH_TYPE : Fly.io のヘッダーベースの認証のApi-Keyに設定します (デフォルトのBearerを上書きします)。

3. テスト

サービスを開始した後、リソースとツールの一覧表示の手順については、JSON-RPC テストのセクションを参照してください。

レンダリング例

Renderは、API経由で管理可能なインフラストラクチャホスティングを提供しています。提供されている設定ファイルexamples/render-claude_desktop_config.jsonは、最小限の設定でMCPエコシステムを迅速にセットアップする方法を示しています。

1. OpenAPI仕様を確認する

Render OpenAPI 仕様を取得します。

curl https://api-docs.render.com/openapi/6140fb3daeae351056086186

応答が有効な OpenAPI ドキュメントであることを確認します。

2. レンダリング用にmcp-openapi-proxyを設定する

MCP エコシステム設定に次の構成を追加します。

{
    "mcpServers": {
        "render": {
            "command": "uvx",
            "args": ["mcp-openapi-proxy"],
            "env": {
                "OPENAPI_SPEC_URL": "https://api-docs.render.com/openapi/6140fb3daeae351056086186",
                "TOOL_WHITELIST": "/services,/maintenance",
                "API_KEY": "your_render_token_here"
            }
        }
    }
}

3. テスト

レンダリング設定でプロキシを起動します。

OPENAPI_SPEC_URL="https://api-docs.render.com/openapi/6140fb3daeae351056086186" TOOL_WHITELIST="/services,/maintenance" API_KEY="your_render_token_here" uvx mcp-openapi-proxy

次に、リソースとツールをリストする手順については、 JSON-RPC テストのセクションを参照してください。

Slackの例

Slack APIでは、JMESPathを使用して不要なトークンペイロードを削除する方法を紹介します。ボットトークンはSlack APIドキュメントから取得してください。

1. OpenAPI仕様を確認する

Slack OpenAPI 仕様を取得します。

curl https://raw.githubusercontent.com/slackapi/slack-api-specs/master/web-api/slack_web_openapi_v2.json

有効な OpenAPI JSON ドキュメントであることを確認します。

2. Slack 用に mcp-openapi-proxy を設定する

設定を更新します:

{
    "mcpServers": {
        "slack": {
            "command": "uvx",
            "args": ["mcp-openapi-proxy"],
            "env": {
                "OPENAPI_SPEC_URL": "https://raw.githubusercontent.com/slackapi/slack-api-specs/master/web-api/slack_web_openapi_v2.json",
                "TOOL_WHITELIST": "/chat,/bots,/conversations,/reminders,/files,/users",
                "API_KEY": "<your_slack_bot_token, starts with xoxb>",
                "STRIP_PARAM": "token",
                "TOOL_NAME_PREFIX": "slack_"
            }
        }
    }
}

OPENAPI_SPEC_URL : Slack の OpenAPI 仕様 URL。
TOOL_WHITELIST : ツールを有用なエンドポイントグループ (チャット、会話、ユーザーなど) に制限します。
API_KEY : Slack ボットトークン (例: xoxb-... 、 <your_slack_bot_token>を置き換えます)。
STRIP_PARAM : リクエストペイロードからトークンフィールドを削除します。
TOOL_NAME_PREFIX : ツール名の先頭にslack_を追加します。

3. テスト

サービスを開始した後、リソースとツールの一覧表示の手順については、JSON-RPC テストのセクションを参照してください。

GetZepの例

GetZepは、詳細なエンドポイントを備えたメモリ管理用の無料クラウドAPIを提供しています。GetZepは公式のOpenAPI仕様を提供していないため、このプロジェクトでは利便性のためにGitHubでホストされた生成された仕様が含まれています。ユーザーは同様に、任意のREST APIのOpenAPI仕様を生成し、ローカルで参照することができます（例： file:///path/to/spec.json ）。APIキーはGetZepのドキュメントから取得してください。

1. OpenAPI仕様を確認する

プロジェクト提供の GetZep OpenAPI 仕様を取得します。

curl https://raw.githubusercontent.com/matthewhand/mcp-openapi-proxy/refs/heads/main/examples/getzep.swagger.json

有効なOpenAPI JSONドキュメントであることを確認してください。または、独自の仕様を生成し、 file:// URLを使用してローカルファイルを参照することもできます。

2. GetZep 用に mcp-openapi-proxy を設定する

設定を更新します:

{
    "mcpServers": {
        "getzep": {
            "command": "uvx",
            "args": ["mcp-openapi-proxy"],
            "env": {
                "OPENAPI_SPEC_URL": "https://raw.githubusercontent.com/matthewhand/mcp-openapi-proxy/refs/heads/main/examples/getzep.swagger.json",
                "TOOL_WHITELIST": "/sessions",
                "API_KEY": "<your_getzep_api_key>",
                "API_AUTH_TYPE": "Api-Key",
                "TOOL_NAME_PREFIX": "zep_"
            }
        }
    }
}

OPENAPI_SPEC_URL : プロジェクト提供の GetZep Swagger 仕様を指します (または、ローカルファイルの場合はfile:///path/to/your/spec.jsonを使用します)。
TOOL_WHITELIST : /sessionsエンドポイントへの制限。
API_KEY : GetZep API キー。
API_AUTH_TYPE : ヘッダーベースの認証にApi-Key使用します。
TOOL_NAME_PREFIX : ツール名の先頭にzep_を追加します。

3. テスト

サービスを開始した後、リソースとツールの一覧表示の手順については、JSON-RPC テストのセクションを参照してください。

Virustotalの例

この例では次のことを示します。

YAML OpenAPI仕様ファイルの使用
カスタム HTTP 認証ヘッダー「x-apikey」を使用する

1. OpenAPI仕様を確認する

Virustotal OpenAPI 仕様を取得します。

curl https://raw.githubusercontent.com/matthewhand/mcp-openapi-proxy/refs/heads/main/examples/virustotal.openapi.yml

応答が有効な OpenAPI YAML ドキュメントであることを確認します。

2. Virustotal用にmcp-openapi-proxyを設定する

MCP エコシステム設定に次の構成を追加します。

{
    "mcpServers": {
        "virustotal": {
            "command": "uvx",
            "args": ["mcp-openapi-proxy"],
            "env": {
                "OPENAPI_SPEC_URL": "https://raw.githubusercontent.com/matthewhand/mcp-openapi-proxy/refs/heads/main/examples/virustotal.openapi.yml",
                "EXTRA_HEADERS": "x-apikey: ${VIRUSTOTAL_API_KEY}",
                "OPENAPI_SPEC_FORMAT": "yaml"
            }
        }
    }
}

主な構成ポイント:

デフォルトでは、プロキシは JSON 仕様を想定し、Bearer プレフィックス付きの API キーを送信します。
YAML OpenAPI 仕様を使用するには、 OPENAPI_SPEC_FORMAT="yaml"を含めます。
注意: VirusTotal には特別な認証ヘッダーが必要です。EXTRA_HEADERS は API キーを「x-apikey: ${VIRUSTOTAL_API_KEY}」として送信するために使用されます。

3. テスト

Virustotal 設定でプロキシを起動します。

OPENAPI_SPEC_URL="https://raw.githubusercontent.com/matthewhand/mcp-openapi-proxy/refs/heads/main/examples/virustotal.openapi.yml" API_KEY="your_virustotal_api_key" API_AUTH_HEADER="x-apikey" API_AUTH_TYPE="" OPENAPI_SPEC_FORMAT="yaml" uvx mcp-openapi-proxy

サービスを開始した後、リソースとツールの一覧表示の手順については、JSON-RPC テストのセクションを参照してください。

概念の例

NotionのAPIでは、HTTPヘッダーで特定のバージョンを指定する必要があります。この例では、 EXTRA_HEADERS環境変数を使用して必要なヘッダーを追加し、OpenAPI仕様の検証に重点を置いています。

1. OpenAPI仕様を確認する

Notion OpenAPI 仕様を取得します。

curl https://storage.googleapis.com/versori-assets/public-specs/20240214/NotionAPI.yml

応答が有効な YAML ドキュメントであることを確認します。

2. Notion用にmcp-openapi-proxyを設定する

MCP エコシステム設定に次の構成を追加します。

{
  "mcpServers": {
    "notion": {
      "command": "uvx",
      "args": [
        "mcp-openapi-proxy"
      ],
      "env": {
          "API_KEY": "ntn_<your_key>",
          "OPENAPI_SPEC_URL": "https://storage.googleapis.com/versori-assets/public-specs/20240214/NotionAPI.yml",
          "SERVER_URL_OVERRIDE": "https://api.notion.com",
          "EXTRA_HEADERS": "Notion-Version: 2022-06-28"
      }
    }
  }
}

3. テスト

Notion 構成でプロキシを起動します。

OPENAPI_SPEC_URL="https://storage.googleapis.com/versori-assets/public-specs/20240214/NotionAPI.yml" SERVER_URL_OVERRIDE="https://api.notion.com" EXTRA_HEADERS="Notion-Version: 2022-06-28" API_KEY="ntn_<your_key>" uvx mcp-openapi-proxy

サービスを開始した後、リソースとツールの一覧表示の手順については、JSON-RPC テストのセクションを参照してください。

アーサナの例

Asana は、ワークスペース、タスク、プロジェクト、ユーザーを管理するための豊富なエンドポイントを提供しています。統合テストではGET /workspaces 、 GET /tasks 、 GET /projectsなどのエンドポイントの使用方法を示します。

1. OpenAPI仕様を確認する

Asana OpenAPI 仕様を取得します。

curl https://raw.githubusercontent.com/Asana/openapi/refs/heads/master/defs/asana_oas.yaml

応答が有効な YAML (または JSON) ドキュメントであることを確認します。

2. Asana 用に mcp-openapi-proxy を設定する

MCP エコシステム設定に次の構成を追加します。

{
  "mcpServers": {
    "asana": {
      "command": "uvx",
      "args": [
        "mcp-openapi-proxy"
      ],
      "env": {
        "OPENAPI_SPEC_URL": "https://raw.githubusercontent.com/Asana/openapi/refs/heads/master/defs/asana_oas.yaml",
        "SERVER_URL_OVERRIDE": "https://app.asana.com/api/1.0",
        "TOOL_WHITELIST": "/workspaces,/tasks,/projects,/users",
        "API_KEY": "${ASANA_API_KEY}"
      }
    }
  }
}

注: ほとんどの Asana API エンドポイントは認証が必要です。有効なトークンを使用して、環境または.envファイルでASANA_API_KEY設定してください。

3. テスト

次のようにしてサービスを開始します。

ASANA_API_KEY="<your_asana_api_key>" OPENAPI_SPEC_URL="https://raw.githubusercontent.com/Asana/openapi/refs/heads/master/defs/asana_oas.yaml" SERVER_URL_OVERRIDE="https://app.asana.com/api/1.0" TOOL_WHITELIST="/workspaces,/tasks,/projects,/users" uvx mcp-openapi-proxy

その後、MCP エコシステムを使用して、 /dcim/devices/や/ipam/ip-addresses/などのエンドポイントのツールを一覧表示したり、呼び出すことができます。

APIs.guruの例

APIs.guru は、数千もの公開 API の OpenAPI 定義ディレクトリを提供します。この例では、mcp-openapi-proxy を使用して APIs.guru ディレクトリを MCP ツールとして公開する方法を示します。

1. OpenAPI仕様を確認する

APIs.guru OpenAPI 仕様を取得します。

curl https://raw.githubusercontent.com/APIs-guru/openapi-directory/refs/heads/main/APIs/apis.guru/2.2.0/openapi.yaml

応答が有効な OpenAPI YAML ドキュメントであることを確認します。

2. APIs.guru 用に mcp-openapi-proxy を設定する

MCP エコシステム設定に次の構成を追加します。

{
    "mcpServers": {
        "apisguru": {
            "command": "uvx",
            "args": ["mcp-openapi-proxy"],
            "env": {
                "OPENAPI_SPEC_URL": "https://raw.githubusercontent.com/APIs-guru/openapi-directory/refs/heads/main/APIs/apis.guru/2.2.0/openapi.yaml"
            }
        }
    }
}

3. テスト

次のようにしてサービスを開始します。

OPENAPI_SPEC_URL="https://raw.githubusercontent.com/APIs-guru/openapi-directory/refs/heads/main/APIs/apis.guru/2.2.0/openapi.yaml" uvx mcp-openapi-proxy

その後、MCP エコシステムを使用して、APIs.guru ディレクトリで定義されているlistAPIs 、 getMetrics 、 getProvidersなどのツールを一覧表示して呼び出すことができます。

ネットボックスの例

NetBoxは、オープンソースのIPアドレス管理（IPAM）およびデータセンターインフラストラクチャ管理（DCIM）ツールです。この例では、mcp-openapi-proxyを使用してNetBox APIをMCPツールとして公開する方法を示します。

1. OpenAPI仕様を確認する

NetBox OpenAPI 仕様を取得します。

curl https://raw.githubusercontent.com/APIs-guru/openapi-directory/refs/heads/main/APIs/netbox.dev/3.4/openapi.yaml

応答が有効な OpenAPI YAML ドキュメントであることを確認します。

2. NetBox用にmcp-openapi-proxyを設定する

MCP エコシステム設定に次の構成を追加します。

{
    "mcpServers": {
        "netbox": {
            "command": "uvx",
            "args": ["mcp-openapi-proxy"],
            "env": {
                "OPENAPI_SPEC_URL": "https://raw.githubusercontent.com/APIs-guru/openapi-directory/refs/heads/main/APIs/netbox.dev/3.4/openapi.yaml",
                "API_KEY": "${NETBOX_API_KEY}"
            }
        }
    }
}

注: ほとんどのNetBox APIエンドポイントは認証が必要です。環境または.envファイルでNETBOX_API_KEY有効なトークンを設定してください。

3. テスト

次のようにしてサービスを開始します。

OPENAPI_SPEC_URL="https://raw.githubusercontent.com/APIs-guru/openapi-directory/refs/heads/main/APIs/netbox.dev/3.4/openapi.yaml" API_KEY="$NETBOX_API_KEY" uvx mcp-openapi-proxy

その後、MCP エコシステムを使用して、 /dcim/devices/や/ipam/ip-addresses/などのエンドポイントのツールを一覧表示したり、呼び出すことができます。

Box APIの例

Boxアカウントへの認証アクセスには、独自の開発者トークンを使用してBox Platform APIを統合できます。この例では、Box APIエンドポイントをMCPツールとして公開する方法を示します。

設定例: `examples/box-claude_desktop_config.json`

{
  "OPENAPI_SPEC_URL": "https://raw.githubusercontent.com/APIs-guru/openapi-directory/refs/heads/main/APIs/box.com/2.0.0/openapi.yaml",
  "API_KEY": "${BOX_API_KEY}"
}

Box開発者トークンを.envの環境変数として設定します。
BOX_API_KEY=your_box_developer_token
または、次の 1 行でプロキシを実行します。
OPENAPI_SPEC_URL="https://raw.githubusercontent.com/APIs-guru/openapi-directory/refs/heads/main/APIs/box.com/2.0.0/openapi.yaml" API_KEY="$BOX_API_KEY" uvx mcp-openapi-proxy

MCPエコシステムを使用してBox APIツールの一覧を表示および呼び出しできるようになりました。統合テストについては、 tests/integration/test_box_integration.pyをご覧ください。

WolframAlpha APIの例

認証アクセスのために、独自のApp IDを使用してWolframAlpha APIを統合できます。この例では、WolframAlpha APIエンドポイントをMCPツールとして公開する方法を示します。

設定例: `examples/wolframalpha-claude_desktop_config.json`

{
  "mcpServers": {
    "wolframalpha": {
      "command": "uvx",
      "args": [
        "mcp-openapi-proxy"
      ],
      "env": {
        "OPENAPI_SPEC_URL": "https://raw.githubusercontent.com/APIs-guru/openapi-directory/refs/heads/main/APIs/wolframalpha.com/v0.1/openapi.yaml",
        "API_KEY": "${WOLFRAM_LLM_APP_ID}"
      }
    }
  }
}

WolframAlpha アプリ ID を.envの環境変数として設定します。
WOLFRAM_LLM_APP_ID=your_wolfram_app_id
または、次の 1 行でプロキシを実行します。
OPENAPI_SPEC_URL="https://raw.githubusercontent.com/APIs-guru/openapi-directory/refs/heads/main/APIs/wolframalpha.com/v0.1/openapi.yaml" API_KEY="$WOLFRAM_LLM_APP_ID" uvx mcp-openapi-proxy

MCPエコシステムを使用して、WolframAlpha APIツールの一覧を表示および呼び出しできるようになりました。統合テストについては、 tests/integration/test_wolframalpha_integration.pyをご覧ください。

トラブルシューティング

JSON-RPC テスト

代替テストとして、JSON-RPC経由でMCPサーバーとやり取りすることもできます。サーバーを起動したら、以下の初期化メッセージを貼り付けてください。

{"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"claude-ai","version":"0.1.0"}},"jsonrpc":"2.0","id":0}

予想される応答:

{"jsonrpc":"2.0","id":0,"result":{"protocolVersion":"2024-11-05","capabilities":{"experimental":{},"prompts":{"listChanged":false},"resources":{"subscribe":false,"listChanged":false},"tools":{"listChanged":false}},"serverInfo":{"name":"sqlite","version":"0.1.0"}}}

次に、次のフォローアップメッセージを貼り付けます。

{"method":"notifications/initialized","jsonrpc":"2.0"}
{"method":"resources/list","params":{},"jsonrpc":"2.0","id":1}
{"method":"tools/list","params":{},"jsonrpc":"2.0","id":2}

**OPENAPI_SPEC_URL がありません:**有効な OpenAPI JSON URL またはローカルファイルパスに設定されていることを確認してください。
無効な仕様: OpenAPI ドキュメントが標準に準拠していることを確認してください。
ツールフィルタリングの問題: TOOL_WHITELIST目的のエンドポイントと一致しているかどうかを確認します。
認証エラー: API_KEYとAPI_AUTH_TYPEが正しいことを確認してください。
ログ: stderr に詳細を出力するには、 DEBUG=trueを設定します。
**テストサーバー:**直接実行:

uvx mcp-openapi-proxy

ライセンス

MITライセンス

Integrations

mcp-openapi-proxy

目次

概要

特徴

インストール

MCPエコシステム統合

動作モード

FastMCPモード（シンプルモード）

低レベルモード（デフォルト）

環境変数

例

Glamaの例

1. OpenAPI仕様を確認する

2. Glama用にmcp-openapi-proxyを設定する

3. テスト

Fly.ioの例

1. OpenAPI仕様を確認する

2. Fly.io 用に mcp-openapi-proxy を設定する

3. テスト

レンダリング例

1. OpenAPI仕様を確認する

2. レンダリング用にmcp-openapi-proxyを設定する

3. テスト

Slackの例

1. OpenAPI仕様を確認する

2. Slack 用に mcp-openapi-proxy を設定する

3. テスト

GetZepの例

1. OpenAPI仕様を確認する

2. GetZep 用に mcp-openapi-proxy を設定する

3. テスト

Virustotalの例

1. OpenAPI仕様を確認する

2. Virustotal用にmcp-openapi-proxyを設定する

3. テスト

概念の例

1. OpenAPI仕様を確認する

2. Notion用にmcp-openapi-proxyを設定する

3. テスト

アーサナの例

1. OpenAPI仕様を確認する

2. Asana 用に mcp-openapi-proxy を設定する

3. テスト

APIs.guruの例

1. OpenAPI仕様を確認する

2. APIs.guru 用に mcp-openapi-proxy を設定する

3. テスト

ネットボックスの例

1. OpenAPI仕様を確認する

2. NetBox用にmcp-openapi-proxyを設定する

3. テスト

Box APIの例

設定例: examples/box-claude_desktop_config.json

WolframAlpha APIの例

設定例: examples/wolframalpha-claude_desktop_config.json

トラブルシューティング

JSON-RPC テスト

ライセンス

Tools

Related Resources

Appeared in Searches

設定例: `examples/box-claude_desktop_config.json`

設定例: `examples/wolframalpha-claude_desktop_config.json`