🤖 OpenAPI MCP サーバー

あらゆる OpenAPI サービスをモデル コンテキスト プロトコル (MCP) サーバーに変換し、MCP 仕様をサポートする AI エージェントおよびツールとのシームレスな統合を可能にするコマンドライン ツール。

[!NOTE] このツールはまだ開発初期段階です。ロードマップはこちらです

モデルコンテキストプロトコル (MCP) とは何ですか?

モデルコンテキストプロトコル（MCP）は、AIエージェントが外部ツールやサービスと連携するための標準化されたプロトコルです。AIモデルが統一されたインターフェースを通じて様々な機能を一貫して発見、理解、活用できるようにすることで、複数のサービスと連携できるAI搭載アプリケーションの構築を容易にします。

Related MCP server: mcpify

OpenAPI とは何ですか?

OpenAPI（旧称Swagger）は、RESTful Webサービスを記述、生成、利用、視覚化するための機械可読インターフェースファイルの仕様です。これにより、人間とコンピューターの両方が、ソースコードや追加のドキュメントにアクセスすることなく、サービスの機能を発見し、理解することができます。

このプロジェクトについて

このミドルウェアは、OpenAPI サービスと MCP クライアント間のブリッジとして機能します。その機能は次のとおりです。

1. OpenAPI仕様ファイルを入力として受け取ります

2. MCP準拠のサーバーを自動生成

3. 受信リクエストを実際の OpenAPI サービスにプロキシします

4. MCP と REST の規則を変換します

これにより、元のサービスに変更を加えることなく、OpenAPI 仕様を備えた既存の REST API に、MCP を理解する AI エージェントがすぐにアクセスできるようになります。

インストール

npm install -g openapi-mcp-proxy

使用法

npx openapi-mcp-proxy --spec ./path/to/openapi.yml --target http://your-api.com --port 3000

オプション

• -s, --spec <path> (必須): OpenAPI 仕様ファイルへのパス (env: OMP_OPENAPI_SPEC_FILE )

• -t, --target <url> (オプション): API サービスのターゲット URL (デフォルト: " http://localhost:8080 "、env: OMP_TARGET_BASE_URL )

• -p, --port <number> (オプション): MCP サーバーを実行するポート (デフォルト: "3000"、env: PORT )

• -V, --version : バージョン番号を表示する

• -h, --help : コマンドのヘルプを表示する

例

Petstore API 用の MCP サーバーを起動します

npx openapi-mcp-proxy --spec resources/petstore.openapi.yml --target https://petstore.swagger.io/v2

テスト

MCP検査官

MCP サーバーをテストするには、モデル コンテキスト プロトコルを使用できます。

1. MCP Inspector をインストールします。

npx @modelcontextprotocol/inspector

2. MCPサーバーを起動する

3. インスペクターのUIに移動し、 /mcpで終わる正しいサーバーパスを入力します（例http://localhost:3000/mcp

4. これでMCPサーバーとやり取りできるようになりました。MCPインスペクターには、リクエストとレスポンスに関する詳細情報が表示されます。

VSコードで

VS Code の組み込みエージェント モードを使用すると、これが簡単になります。

1. VS Code を開き、エージェント モードを有効にします。

   • Cmd/Ctrl + Shift + Pを押します

   • 「GitHub Copilot Agent モードを切り替える」と入力します

   • 「有効にする」を選択

2. MCP サーバーを追加します:

   • Cmd/Ctrl + Shift + Pを押します

   • 「MCP: サーバーを追加」と入力します

   • MCP サーバーの URL をhttp://localhost:3000/mcpのように入力します**(末尾に/mcpが付きます)。**

3. Github Copilot チャットでは、新しいツールが取り上げられるはずです。

4. これで、VS Codeのエージェントインターフェースを介してMCPサーバーとやり取りできるようになりました。「今、ペットは何匹いますか？」と聞いてみてください。

VSコードでMCPサーバーを使用する方法の詳細については、 こちらをご覧ください。

貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。ロードマップはこちらです。

ライセンス

マサチューセッツ工科大学