OpenAPI スキーマ MCP サーバー

「OpenAPI スキーマ」MCP サーバーは何をするもの？

OpenAPI スキーマ MCP サーバーは、Claude などの大規模言語モデル（LLM）向けに OpenAPI スキーマ情報を公開する Model Context Protocol (MCP) サーバーです。OpenAPI 仕様への構造化アクセスを提供することで、AI アシスタントが API のエンドポイント、パラメータ、リクエスト・レスポンススキーマなどを探索・理解できるようになります。これにより、開発者や AI ツールは API 構造のクエリや仕様横断検索、詳細なスキーマ定義の取得ができ、API 連携やドキュメント作成、コード生成などのワークフローが強化されます。サーバーは JSON または YAML 形式の OpenAPI ファイルの読み込みに対応し、結果は LLM の理解向上のため YAML で返します。

プロンプト一覧

リポジトリ内に明示的なプロンプトテンプレートは記載されていません。

リソース一覧

リポジトリ内に明示的なリソース定義は記載されていません。

ツール一覧

OpenAPI スキーマ MCP サーバーは LLM 向けに次のツールを提供します：

• list-endpoints: すべての API パスと HTTP メソッド、その要約をネストしたオブジェクト形式で一覧表示します。
• get-endpoint: 指定したエンドポイントの詳細（パラメータ、レスポンスなど）を取得します。
• get-request-body: 特定エンドポイント・HTTP メソッドのリクエストボディスキーマを提供します。
• get-response-schema: 特定エンドポイント・メソッド・ステータスコードのレスポンススキーマを返します。
• get-path-parameters: 特定パスのパラメータを取得します。
• list-components: すべてのスキーマコンポーネント（schemas, responses, parameters など）を一覧表示します。
• get-component: 指定したコンポーネントの詳細定義を返します。
• list-security-schemes: API に登録されているセキュリティスキームを一覧表示します。
• get-examples: 指定コンポーネントやエンドポイントのサンプルを取得します。
• search-schema: OpenAPI 仕様内のパス、オペレーション、スキーマを横断検索します。

この MCP サーバーのユースケース

• API 探索・ドキュメント作成: 開発者や LLM がエンドポイントやパラメータ、スキーマをすばやく一覧取得し、API 構造の理解やドキュメント作成を容易にします。
• 自動コード生成: リクエスト・レスポンススキーマをプログラム的に取得して、クライアントライブラリやコードスニペットを自動生成できます。
• API テスト・バリデーション: テストツールがパラメータやサンプルペイロードを取得し、自動または手動テストをサポートします。
• セキュリティレビュー: 利用可能なセキュリティスキームや各エンドポイントへの実装状況を分析し、API のセキュリティ確保に役立てます。
• スキーマ検索・分析: 大規模 API 仕様内で特定エンティティや機能に関連するスキーマやエンドポイントをすばやく検索・分析できます。

セットアップ方法

Windsurf

Windsurf 用のセットアップ手順はありません。

Claude

1. Node.js と npx がインストールされていることを確認します。
2. Claude Desktop の設定ファイルを探します:
   • macOS/Linux: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: $env:AppData\Claude\claude_desktop_config.json
3. mcpServers オブジェクトの下に OpenAPI スキーマ MCP サーバーを追加します:

   {
     "mcpServers": {
       "OpenAPI Schema": {
         "command": "npx",
         "args": ["-y", "mcp-openapi-schema", "/ABSOLUTE/PATH/TO/openapi.yaml"]
       }
     }
   }
   

4. ファイルを保存し、Claude Desktop を再起動します。
5. Claude UI でサーバーが利用できることを確認します。

Cursor

Cursor 用のセットアップ手順はありません。

Cline

Claude Code CLI

1. Node.js と npx がインストールされていることを確認します。
2. OpenAPI スキーマ MCP サーバーを追加します:

   claude mcp add openapi-schema npx -y mcp-openapi-schema
   

   または、特定のスキーマファイルを指定する場合:

   claude mcp add petstore-api npx -y mcp-openapi-schema ~/Projects/petstore.yaml
   

3. 登録を確認します:

   claude mcp list
   claude mcp get openapi-schema
   

4. 必要に応じてサーバーを削除します:

   claude mcp remove openapi-schema
   

5. Claude Code セッションで各ツールを利用します。

API キーのセキュリティ

API キーのセキュリティや環境変数利用についての情報はありません。

フロー内でこの MCP を使う方法

FlowHunt での MCP 利用

FlowHunt ワークフローに MCP サーバーを統合するには、フローに MCP コンポーネントを追加し、AI エージェントと接続します。

MCP コンポーネントをクリックして設定パネルを開きます。system MCP 設定セクションに、以下の JSON 形式で MCP サーバー情報を入力します。

{
  "MCP-name": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

設定が完了すると、AI エージェントはこの MCP のすべての機能・ツールにアクセスできるようになります。“MCP-name” は実際のサーバー名（例: “github-mcp”, “weather-api” など）に、URL もご自身の MCP サーバーの URL に置き換えてください。

概要

現時点のドキュメントから判断すると、OpenAPI スキーマ MCP サーバーは LLM による OpenAPI 探索に特化した強力なツール群を提供していますが、プロンプトやリソース、API キーの取扱い、MCP の高度な機能に関する記載はありません。OpenAPI 向け用途には強力ですが、より広範な MCP 機能面では制限があります。

MCP スコア

評価:
この MCP サーバーの評価は 6/10 です。OpenAPI スキーマ探索のために良く設計され、充実したツール群を備えていますが、MCP プロンプトテンプレートやリソース定義、セキュリティのベストプラクティス、ルートやサンプリングサポートへの言及がなく、ライセンス未記載もオープンなコラボレーションには大きな制約です。