「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
- Node.js と
npxがインストールされていることを確認します。 - Claude Desktop の設定ファイルを探します:
- macOS/Linux:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
$env:AppData\Claude\claude_desktop_config.json
- macOS/Linux:
mcpServersオブジェクトの下に OpenAPI スキーマ MCP サーバーを追加します:{ "mcpServers": { "OpenAPI Schema": { "command": "npx", "args": ["-y", "mcp-openapi-schema", "/ABSOLUTE/PATH/TO/openapi.yaml"] } } }- ファイルを保存し、Claude Desktop を再起動します。
- Claude UI でサーバーが利用できることを確認します。
Cursor
Cursor 用のセットアップ手順はありません。
Cline
Claude Code CLI
- Node.js と
npxがインストールされていることを確認します。 - OpenAPI スキーマ MCP サーバーを追加します:または、特定のスキーマファイルを指定する場合:
claude mcp add openapi-schema npx -y mcp-openapi-schemaclaude mcp add petstore-api npx -y mcp-openapi-schema ~/Projects/petstore.yaml - 登録を確認します:
claude mcp list claude mcp get openapi-schema - 必要に応じてサーバーを削除します:
claude mcp remove openapi-schema - 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 スキーマ用 10 ツール記載 |
| API キーセキュリティ | ⛔ | 記載なし |
| サンプリングサポート(評価時は重要度低) | ⛔ | 記載なし |
現時点のドキュメントから判断すると、OpenAPI スキーマ MCP サーバーは LLM による OpenAPI 探索に特化した強力なツール群を提供していますが、プロンプトやリソース、API キーの取扱い、MCP の高度な機能に関する記載はありません。OpenAPI 向け用途には強力ですが、より広範な MCP 機能面では制限があります。
MCP スコア
| LICENSE の有無 | ⛔ |
|---|---|
| ツールが 1 つ以上ある | ✅ |
| フォーク数 | 9 |
| スター数 | 30 |
評価:
この MCP サーバーの評価は 6/10 です。OpenAPI スキーマ探索のために良く設計され、充実したツール群を備えていますが、MCP プロンプトテンプレートやリソース定義、セキュリティのベストプラクティス、ルートやサンプリングサポートへの言及がなく、ライセンス未記載もオープンなコラボレーションには大きな制約です。
