Openapi To MCP Server

🚀 OpenAPI を MCP 設定に変換するツール

このツールは、OpenAPI 仕様を MCP 設定に変換するための便利なツールです。OpenAPI の情報を元に、MCP で必要な設定を自動生成し、パラメータやレスポンスの情報も適切に保持します。

✨ 主な機能

• パス変換：OpenAPI のパスを MCP ツールに変換します。
• ファイル形式のサポート：JSON および YAML 形式の OpenAPI 仕様をサポートします。
• 設定生成：サーバーとツールの定義を含む MCP 設定を生成します。
• パラメータ説明の保持：パラメータの説明とタイプ情報を保持します。
• 自動位置設定：OpenAPI パラメータの位置に基づいて position フィールドを自動設定します。
• 複数のパラメータタイプのサポート：パス、クエリ、ヘッダー、クッキー、および本文のパラメータをサポートします。
• レスポンステンプレートの生成：フィールドの説明と改善された形式を含むレスポンステンプレートを生成し、LLM が理解しやすくします。
• オプションの仕様検証：OpenAPI 仕様の検証機能を提供します（デフォルトでは無効）。
• テンプレートパッチのサポート：生成された設定に対して、テンプレートに基づくカスタム変更をサポートします。

📦 インストール

READMEにインストール手順が記載されていないため、このセクションをスキップします。

💻 使用例

基本的な使用法

openapi-to-mcp --input api-spec.json --output mcp-server.yaml --server-name my-server --template template.yaml

テンプレートパッチ機能

--template フラグを使用することで、生成された設定に対して YAML ファイルを使用してパッチ式の変更を行うことができます。これは、共通のヘッダー、認証情報、またはその他のカスタム設定を追加するのに便利です。

テンプレートファイルの例

server:
  config:
    apiKey: ""

tools:
  requestTemplate:
    headers:
      - key: Authorization
        value: "APPCODE {{.config.apiKey}}"
      - key: X-Ca-Nonce
        value: "{{uuidv4}}"

適用後の動作

1. サーバー設定に apiKey フィールドを追加します。
2. 指定されたヘッダー情報をすべてのツールの設定に追加します。

テンプレート内のプレースホルダー（例：{{.config.apiKey}} または "{{uuidv4}}"）は、このツールでは処理されず、出力ファイルにそのまま残り、MCP サーバーが実行時に使用できるようになります。

📚 ドキュメント

READMEに詳細なドキュメントが記載されていないため、このセクションをスキップします。

🔧 技術詳細

READMEに技術的な詳細が記載されていないため、このセクションをスキップします。

📄 ライセンス

READMEにライセンス情報が記載されていないため、このセクションをスキップします。