OpenAPI MCP Server

OpenAPI MCP サーバー

概要

• このプロジェクトでは、設定済みの REST API を LLM のコンテキストとして提供する MCP - Model Context Protocol Server をインストールします。
• これを使用することで、LLM が REST API と対話し、LLM のプロンプトを使用して REST API を呼び出せるようになります。
• 現在、HTTP API 呼び出し GET/PUT/POST/PATCH に対応しています。

インストール

• パッケージをインストールします

  pip install openapi_mcp_server
  

• .env をフォルダー内に作成し、OPENAPI_SPEC_PATH と API_BASE_URL に最低限の値を設定します。サンプルファイルはこちらから入手できます。
• 上記のフォルダーから uv run openapi_mcp_server を実行し、openapi_mcp_server サーバーをテストします。

Claud Desktop

• Claud Desktop の設定詳細

  {
    "mcpServers": {
      "openapi_mcp_server":{
        "command": "uv",
        "args": ["run","openapi_mcp_server"]
        "env": {
            "DEBUG":"1",
            "API_BASE_URL":"https://petstore.swagger.io/v2",
            "OPENAPI_SPEC_PATH":"https://petstore.swagger.io/v2/swagger.json",
            "API_HEADERS":"Accept:application/json",
            "API_WHITE_LIST":"addPet,updatePet,findPetsByStatus"
        }
      }
    }
  }
  

  

設定

• 使用可能な環境変数の一覧
  • DEBUG：デバッグログを有効にします（省略可能。デフォルトは False）
  • OPENAPI_SPEC_PATH：OpenAPI ドキュメントへのパスです（必須）
  • API_BASE_URL：API リクエストのベース URL です（必須）
  • API_HEADERS：API リクエストに含めるヘッダーです（省略可能）
  • API_WHITE_LIST：リスト形式の許可対象 operationId（["operationId1", "operationId2"]）（省略可能）
  • API_BLACK_LIST：リスト形式の禁止対象 operationId（["operationId3", "operationId4"]）（省略可能）
  • HTTP_PROXY：HTTP プロキシの詳細（省略可能）
  • HTTPS_PROXY：HTTPS プロキシの詳細（省略可能）
  • NO_PROXY：プロキシを使用しない設定の詳細（省略可能）

貢献

貢献を歓迎します。
お気軽にプルリクエストをお送りください。

ライセンス

このプロジェクトは MIT ライセンスの条件に基づいてライセンスされています。

GitHub スター数

付録

UV

mkdir -m777 openapi_mcp_server
cd openapi_mcp_server
uv init
uv add mcp[cli] pydantic python-dotenv requests
uv add --dev twine setuptools
uv sync
uv run openapi_mcp_server
uv build
pip install --force-reinstall --no-deps .\dist\openapi_mcp_server-*fileversion*.whl
export TWINE_USERNAME="rahgadda"
export TWINE_USERNAME="<<API Key>>"
uv run twine upload --verbose dist/*

参考資料

• UV の概要