Openapi Proxy

🚀 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 つのステップで動作します。

1. 必要な OpenAPI 識別子を特定する
2. その識別子の簡潔な要約をリクエストする
3. 具体的なエンドポイントを特定し、その機能を詳細に説明する（同じく簡潔な言葉で）

⚠️ 重要な注意

OpenAPI MCP は新しいオーナーを見つけ、v1.2 から v2 に移行しました。以前のバージョンとは異なります。v2.0.0 以前のバージョンとその README ファイルには、こちら からアクセスできます。

OpenAPI MCP v2 は開発中のバージョンで、API 探索とコンテキスト情報の提供に重点を置いています。現在、認証が MCP で解決されていないため、エンドポイントをツールとして直接実行することはサポートされていません。ただし、コード生成には非常に役立ちます！

バグが予想されます。貢献者は DM を歓迎します。

✨ 主な機能

• 任意の OpenAPI 仕様の概要を取得する
• 特定の API 操作の詳細情報を取得する
• JSON および YAML 形式をサポートする
• Claude Desktop および Cursor でテスト済み

📦 インストール

Smithery を通じたインストール

Smithery を通じて openapi-mcp-server を自動的にインストールするには、以下のコマンドを実行します。

npx -y @smithery/cli install @janwilmake/openapi-mcp-server --client claude

npx を通じたインストール

以下のコマンドを実行し、指示に従ってください。

npx openapi-mcp-server@latest init

💻 使用例

基本的な使用法

インストールが完了したら、Claude に以下のような操作を実行させることができます。

• "Stripe API に関する情報を探す"
• "GitHub API のリポジトリエンドポイントの使い方を説明する"

Claude は MCP サーバーを通じて以下のことを行います。

1. 最初に、リクエストされた API の概要を取得する
2. 必要に応じて、特定の操作の詳細を取得する

🔧 必要条件

• Node.js >= 16.17.0
• Claude Desktop、Cursor、またはその他の MCP クライアント

📄 ライセンス

MIT