openapi2mcp

openapi2mcp

OpenAPI 3.x 仕様を FastMCP サーバーに変換するツールです。

インストール

poetry install

使用方法／コマンド

openapi2mcp は、OpenAPI 仕様から MCP サーバーのコードを生成、管理するためのコマンドラインインターフェースを提供します。

generate

OpenAPI 仕様ファイルから MCP サーバーの Python コードを生成します。

構文：

openapi2mcp generate [OPTIONS]

オプション：

• -i, --input-file PATH：OpenAPI 仕様ファイル（JSON または YAML）へのパスです。（必須）
• -o, --output-file PATH：生成された MCP サーバーの出力 Python ファイルへのパスです。（必須）
• -t, --transport [stdio|google_pubsub]：MCP サーバーのトランスポート方式です。（デフォルト：stdio）
• --llms-txt-file PATH：llms.txt ファイルを生成するための任意のパスです。このファイルには、生成されたツールとリソースの LLM 向け説明が記載されます。指定しない場合、llms.txt は出力サーバーファイルと同じディレクトリに作成されます。
• --mount TEXT：リソースの任意のマウントパスです（例：/myapi/v1）。（デフォルト：""）

例：

openapi2mcp generate --input-file examples/example_openapi.yaml --output-file generated_server.py --transport stdio --mount "/api"

このコマンドは examples/example_openapi.yaml を解析し、stdio トランスポートを使用する generated_server.py という名前の MCP サーバーファイルを生成して、リソースのマウントパスを /api に設定します。また、generated_server.py と同じディレクトリに llms.txt ファイルを生成します。

check

生成された MCP サーバーの Python ファイルについて、構文や主要な MCP パターンの有無など、基本的なコードの妥当性を確認します。

構文：

openapi2mcp check --server-file PATH

オプション：

• --server-file PATH：確認する、生成済み MCP サーバーの Python ファイルへのパスです。（必須）

例：

openapi2mcp check --server-file generated_server.py

version

openapi2mcp ツールのバージョンを表示します。

構文：

openapi2mcp version

例：

openapi2mcp version

例

実装例を参照してください：

• HTTP サーバー
• SSE サーバー
• STDIO サーバー
• OpenAPI 仕様のサンプル

プロジェクト構成

• openapi2mcp/parser.py：OpenAPI 仕様パーサー
• openapi2mcp/generator.py：FastMCP サーバーコードジェネレーター
• openapi2mcp/cli.py：コマンドラインインターフェース

ライセンス

MIT - LICENSE を参照