OpenAPI MCP Server について
OpenAPI MCP Server は、Claude や Cursor などのクライアントから OpenAPI 仕様を検索・閲覧するための MCP サーバーです。oapis.org から仕様を取得し、平易な言葉で内容を示すため、複雑な API を扱う開発者に向いています。
主な機能
- 01OpenAPI 仕様の検索
- 02仕様の概要の取得
- 03特定の API 操作の詳細の取得
- 04JSON と YAML 形式への対応
活用シーン
- 01コーディング中にサードパーティ API の構造を把握する
- 02API 内から特定の作業に使うエンドポイントを探す
MCP 対応
本プロジェクトは MCP サーバーとして、Claude Desktop や Cursor などの MCP クライアントに OpenAPI 仕様の問い合わせと閲覧機能を提供します。リモートサーバーのエンドポイントは https://openapi-mcp.openapisearch.com/mcp です。
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
https://openapi-mcp.openapisearch.com/mcpclaude mcp add --transport http openapi https://openapi-mcp.openapisearch.com/mcp{"mcpServers":{"openapi":{"type":"http","url":"https://openapi-mcp.openapisearch.com/mcp"}}}Cursor で開く{"servers":{"openapi":{"type":"http","url":"https://openapi-mcp.openapisearch.com/mcp"}}}VS Code で開く{"mcpServers":{"openapi":{"type":"http","url":"https://openapi-mcp.openapisearch.com/mcp"}}}{"mcpServers":{"openapi":{"serverUrl":"https://openapi-mcp.openapisearch.com/mcp"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
ツール
2| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| id | string | はい | API識別子。openapisearch.comの既知のID、または生のOpenAPIファイルを指すURLを指定できます |
詳細
OpenAPI MCP サーバー
Claude/Cursor 向けの Model Context Protocol（MCP）サーバーです。oapis.org を通じて、OpenAPI 仕様を検索、閲覧できます。
- デモ：https://x.com/janwilmake/status/1903497808134496583
- HN スレッド：https://news.ycombinator.com/item?id=43447278
- OpenAPISearch：https://github.com/janwilmake/openapisearch
- OAPIS：https://github.com/janwilmake/oapis
この MCP は、次の 3 ステップのプロセスで動作します。
- 必要な OpenAPI 識別子を特定します
- その概要を平易な言葉で取得します
- 必要なエンドポイントを特定し、その正確な動作を確認します（これも平易な言葉で行います）
機能
- あらゆる OpenAPI 仕様の概要を取得
- 特定の API オペレーションの詳細を取得
- JSON と YAML の両形式に対応
- Claude Desktop と Cursor でテスト済み
インストール
その他のクライアントでは、MCP URL を使用してください：https://openapi-mcp.openapisearch.com/mcp
ローカルテスト
まず、サーバーを起動します
wrangler dev
次に、MCP インスペクターを起動します：
npx @modelcontextprotocol/inspector
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。