MCP Openapi Proxy

mcp-openapi-proxyはPythonパッケージで、OpenAPI仕様のREST APIをMCPツールとして動的に公開するモデルコンテキストプロトコル（MCP）サーバーを実装し、MCPワークフローに簡単に統合できるようにします。

開発者ツールクラウドプラットフォーム #APIプロキシ #動的ツール #MCP統合 #OpenAPI .Python

スコア : 2.5ポイント

ダウンロード数 : 8.7K

更新時間 : 2025-04-23

サイトを開く

MCPオープンAPIプロキシとは？

MCPオープンAPIプロキシは、REST APIを動的にMCPツールに変換するサーバーで、開発者がさまざまなAPIを簡単に統合して使用できるようにします。

MCPオープンAPIプロキシをどのように使用する？

OpenAPI仕様ファイルのURLを設定するだけで、サポートされているAPIをすぐに有効にできます。

適用シナリオ

自動化ツールやデータ統合プラットフォームなど、複数のAPIを迅速に統合する必要があるプロジェクトに適しています。

主要機能

動的ツール生成

OpenAPI定義内の各有効なエンドポイントに対応するMCPツールを自動的に作成します。

シンプルモード

事前定義された一連のツールを提供し、設定手順を簡素化します。

OpenAPI仕様のサポート

OpenAPI v3と互換性があり、将来的にv2もサポートする可能性があります。

カスタム認証

JMESPath式を使用した認証をサポートします。

利点

複数のAPIを迅速に統合する

動的にツールを生成し、手動での設定が不要

複数の認証方式をサポートする

制限

複雑なAPIには追加の設定が必要になる場合がある

有効なOpenAPI仕様ファイルに依存する

使い方

インストール

PyPIを通じてMCPオープンAPIプロキシをインストールします。

設定

OPENAPI_SPEC_URLなどの必要な環境変数を設定します。

サーバーを起動する

サーバーを実行してAPIを公開します。

使用例

Glamaの例

Glama APIを迅速に検証します。

Fly.ioの例

Fly.ioマシンを管理します。

よくある質問

OpenAPI仕様ファイルが有効であることをどのように確認する？

APIにカスタム認証が必要な場合はどうすればいい？

インストール

以下のコマンドをクライアントにコピーして設定

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

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

{
    "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>"
            }
        }
    }
}

{
    "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"
            }
        }
    }
}

{
    "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_"
            }
        }
    }
}

{
    "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_"
            }
        }
    }
}

{
    "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"
            }
        }
    }
}

{
  "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"
      }
    }
  }
}

{
  "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}"
      }
    }
  }
}

{
    "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"
            }
        }
    }
}

{
    "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}"
            }
        }
    }
}

{
  "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}"
      }
    }
  }
}

注意：あなたのキーは機密情報です。誰とも共有しないでください。

🚀 MCP サーバー構成ガイド

MCP サーバーは、特定の環境でのアプリケーションの実行や管理を支援するためのサーバーです。このガイドでは、MCP サーバーのインストール、構成、使用方法、トラブルシューティングなどについて説明します。

🚀 クイックスタート

MCP サーバーを使用するには、まず必要な依存関係をインストールし、サーバーを構成する必要があります。以下の手順に従って設定を行ってください。

✨ 主な機能

複数の環境（開発環境、本番環境など）でのサーバー構成をサポート
環境変数を使用した柔軟な設定
様々な API との連携が可能

📦 インストール

MCP サーバーを実行するには、以下の依存関係を事前にインストールする必要があります。

Node.js (推奨バージョン: 16.x 以上)
npm (推奨バージョン: 7.x 以上)

インストールコマンドは以下の通りです。

npm install -g mcp-server

📚 ドキュメント

構成例ファイル

以下は、典型的な MCP サーバーの構成ファイルの例です。

{
  "mcpServers": {
    "development": {
      "command": "uvx",
      "args": ["mcp-server"],
      "env": {
        "NODE_ENV": "development",
        "PORT": 3000,
        "API_KEY": "your_api_key_here"
      }
    },
    "production": {
      "command": "uvx",
      "args": ["mcp-server"],
      "env": {
        "NODE_ENV": "production",
        "PORT": 3001,
        "API_KEY": "your_production_api_key"
      }
    }
  }
}

環境変数の構成

MCP サーバーがサポートする主要な環境変数は以下の通りです。

OPENAPI_SPEC_URL：OpenAPI 仕様の URL またはローカルファイルパスを指定します。
TOOL_WHITELIST：許可されるツールエンドポイントをコンマ区切りの文字列で指定します。
API_KEY：API アクセスキーを指定します。
DEBUG：デバッグモードを有効にします（値が true の場合）。

使用例

OPENAPI_SPEC_URL="https://example.com/openapi.yaml" TOOL_WHITELIST="/users,/posts" uvx mcp-server

💻 使用例

基本的な使用法

以下は、MCP サーバーの典型的な構成ファイルです。

{
  "mcpServers": {
    "default": {
      "command": "uvx",
      "args": ["mcp-server"],
      "env": {
        "OPENAPI_SPEC_URL": "https://example.com/openapi.json",
        "TOOL_WHITELIST": "/users,/posts",
        "API_KEY": "your_api_key"
      }
    }
  }
}

高度な使用法

以下は、Box API の構成例です。

{
  "mcpServers": {
    "box": {
      "command": "uvx",
      "args": ["mcp-server"],
      "env": {
        "OPENAPI_SPEC_URL": "https://raw.githubusercontent.com/APIs-guru/openapi-directory/refs/heads/main/APIs/box.com/2.0.0/openapi.yaml",
        "TOOL_WHITELIST": "/files,/folders",
        "BOX_API_KEY": "your_box_api_key"
      }
    }
  }
}

以下は、Wolfram Alpha API の構成例です。

{
  "mcpServers": {
    "wolfram-alpha": {
      "command": "uvx",
      "args": ["mcp-server"],
      "env": {
        "OPENAPI_SPEC_URL": "https://example.com/wolfram-alpha/openapi.json",
        "WOLFRAM_API_KEY": "your_wolfram_api_key"
      }
    }
  }
}

🔧 技術詳細

一般的な問題と解決策

問題: OpenAPI 仕様ファイルが見つからない
- 解決策: OPENAPI_SPEC_URL が正しいか確認し、パスがアクセス可能であることを確認してください。
問題: ツールエンドポイントが拒否される
- 解決策: TOOL_WHITELIST に必要なエンドポイントが含まれているか確認し、または null に設定してすべてのエンドポイントを許可します。
問題: API リクエストが失敗する
- 解決策: API_KEY が有効であることを確認し、API サービスが正常に動作していることを確認してください。

ログ記録

MCP サーバーは以下のログ記録レベルをサポートしています。

debug
info
warning
error

📄 ライセンス

このプロジェクトは MIT ライセンスに従います。具体的な条項は以下の通りです。

MIT License

Copyright (c) [year] [author]

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

以上が MCP サーバーの完全な構成ガイドです。さらなる支援が必要な場合は、公式ドキュメントを参照するか、サポートチームにお問い合わせください。