mcp-openapi-schema

OpenAPI スキーマ モデル コンテキスト プロトコル サーバー

Claudeのような大規模言語モデル（LLM）にOpenAPIスキーマ情報を公開するモデルコンテキストプロトコル（MCP）サーバー。このサーバーにより、LLMは専用のツールセットを通じてOpenAPI仕様を探索し、理解することができます。

特徴

• コマンドライン引数で指定された任意の OpenAPI スキーマファイル (JSON または YAML) をロードします。
• API パス、操作、パラメータ、スキーマを調べる
• 詳細なリクエストとレスポンスのスキーマを表示する
• コンポーネントの定義と例を調べる
• API仕様全体を検索
• LLM をより良く理解するために、YAML 形式で応答を取得します。

使用法

コマンドライン

特定のスキーマ ファイルを使用して MCP サーバーを実行します。

クロードデスクトップ統合

この MCP サーバーを Claude Desktop で使用するには、 claude_desktop_config.json構成ファイルを編集します。

設定ファイルの場所:

• macOS/Linux: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: $env:AppData\Claude\claude_desktop_config.json

クロード・コード統合

この MCP サーバーを Claude Code CLI で使用するには、次の手順に従います。

1. Claude CodeにOpenAPIスキーマMCPサーバーを追加する
   # Basic syntax claude mcp add openapi-schema npx -y mcp-openapi-schema # Example with specific schema claude mcp add petstore-api npx -y mcp-openapi-schema ~/Projects/petstore.yaml
2. MCPサーバーが登録されていることを確認する
   # List all configured servers claude mcp list # Get details for your OpenAPI schema server claude mcp get openapi-schema
3. 必要に応じてサーバーを削除する
   claude mcp remove openapi-schema
4. Claude Codeのツールを使用する設定が完了すると、OpenAPI スキーマに関する質問をすることで、Claude Code セッションでツールを呼び出すことができます。

ヒント:

• -sまたは--scopeフラグをproject （デフォルト）またはglobalとともに使用して、構成が保存される場所を指定します。
• 異なる名前を持つ異なる API に複数の MCP サーバーを追加する

MCPツール

サーバーは、LLM が OpenAPI スキーマと対話するための次のツールを提供します。

• list-endpoints : すべての API パスとその HTTP メソッドを、ネストされたオブジェクト構造の概要とともに一覧表示します。
• get-endpoint : パラメータやレスポンスを含む特定のエンドポイントに関する詳細情報を取得します。
• get-request-body : 特定のエンドポイントとメソッドのリクエストボディスキーマを取得します。
• get-response-schema : 特定のエンドポイント、メソッド、ステータスコードのレスポンススキーマを取得します。
• get-path-parameters : 特定のパスのパラメータを取得します
• list-components : すべてのスキーマ コンポーネント (スキーマ、応答、パラメーターなど) を一覧表示します。
• get-component : 特定のコンポーネントの詳細な定義を取得します
• list-security-schemes : 利用可能なすべてのセキュリティスキームを一覧表示します
• get-examples : 特定のコンポーネントまたはエンドポイントの例を取得します
• search-schema : パス、操作、スキーマを検索します

例

試してみるクエリの例: