OpenAPI → MCP Server

OpenAPI → MCP サーバー

OpenAPI 仕様から Node.js/TypeScript の MCP サーバーを診断、差分比較、生成、実行、テストするスタンドアロン CLI です。

インストール

PyPI から openapi-to-mcp-cli をインストールします。Python 3.14 以降が必要です。 生成されたサーバーのビルドと実行には、Node.js 22 以降と npm も必要です。

uv tool install openapi-to-mcp-cli
openapi-to-mcp --help

インストール後もコマンドは openapi-to-mcp のままです。1 回限りの使用には、次のようにします。

uvx --from openapi-to-mcp-cli openapi-to-mcp --help

アップグレード、タグ付き Git インストール、リリース成果物については、インストールガイドを参照してください。

クイックスタート

再利用可能なプロジェクトを生成します。

openapi-to-mcp generate \
  --openapi-json ./openapi.yaml \
  --output-dir ./generated-server

仕様から直接実行します。

openapi-to-mcp run \
  --openapi-json https://petstore3.swagger.io/api/v3/openapi.json \
  --target-api-base-url https://petstore3.swagger.io/api/v3

実行中のサーバーのスモークテストを行います。

openapi-to-mcp test-server \
  --transport streamable-http \
  --host 127.0.0.1 \
  --port 8080 \
  --mcp-endpoint /mcp \
  --list-tools

ドキュメント

製品の公開ドキュメントは GitHub Pages で公開されています。

• ドキュメントのトップページ：nihal1294.github.io/openapi-to-mcp

現在の機能

• stdio および streamable-http の生成ターゲット
• doctor による仕様の準備状況の診断
• diff による MCP サーフェスの比較
• mcpgen.yaml による再現可能な生成ポリシー
• src/custom/tools.ts による再生成に安全なカスタムツール
• 仕様のメタデータから生成される、より詳細なツールの説明と入力例
• 先頭にタグを付けた、グループ化されたツール名のオプション
• streamable-http の呼び出し元向けに、リクエスト単位で指定するツール許可リストのオプション
• リクエストとレスポンスのペイロードを対象とする、機密情報をマスキングした監査ログのオプション
• 安全な上流呼び出し向けの、オプションの再試行予算とサーキットブレーカー
• 明示的なランタイム制御を基盤とする、レビュー可能なパフォーマンスプリセット
• generation_report.json を使った、デフォルトでの厳格モード
• apiKey、bearer、OAuth2、OpenID Connect 用の、生成された認証環境変数マッピング
• 同時実行数、キューイング、タイムアウト、上限付きキャッシュ、レート制限、再試行、サーキットブレーカーを制御する、生成されたランタイム制御
• ローカルのモック API に対する、生成サーバーの E2E テスト
• generate、run、test-server を対象とする CLI の E2E テスト
• master における、バージョン対応の PyPI および GitHub Releases 自動化

Swagger 2 のサポート

Swagger 2 のレスポンスのみのオペレーションとベース URL フィールドに対応しています。Swagger 2 の body または form パラメーター、トップレベルのパラメーター型、セキュリティ定義、またはサポートされていないプロトコルのオーバーライドを使用するオペレーションは、生成前に OpenAPI 3 に変換してください。openapi-to-mcp doctor を実行すると、該当するオペレーションとフィールドを特定できます。

開発

リポジトリ内のワークフローについては、リポジトリのドキュメントを直接参照してください。

• ソースとローカルのワークフロー：ローカルワークフロー
• 貢献ガイド：貢献方法

ライセンス

Apache License 2.0。LICENSE を参照してください。