OpenAPI MCP サーバー

OpenAPIエンドポイントをMCPリソースとして公開するモデルコンテキストプロトコル（MCP）サーバー。このサーバーにより、大規模言語モデルはMCPプロトコルを介してOpenAPI仕様で定義されたREST APIを検出し、操作できるようになります。

概要

この MCP サーバーは、次の 2 つのトランスポート方法をサポートしています。

Stdio トランスポート(デフォルト): 標準入出力を介して MCP 接続を管理する Claude Desktop などの AI システムと直接統合します。
ストリーミング可能な HTTP トランスポート: HTTP 経由でサーバーに接続し、Web クライアントやその他の HTTP 対応システムが MCP プロトコルを使用できるようにします。

Related MCP server: File Context MCP

ユーザー向けクイックスタート

オプション 1: Claude Desktop (Stdio トランスポート) を使用する

このリポジトリをクローンする必要はありません。Claude Desktop をこの MCP サーバーを使用するように設定するだけで済みます。

Claude Desktop 構成ファイルを見つけるか作成します。
- macOSの場合: ~/Library/Application Support/Claude/claude_desktop_config.json
次の構成を追加します。

{ "mcpServers": { "openapi": { "command": "npx", "args": ["-y", "@ivotoby/openapi-mcp-server"], "env": { "API_BASE_URL": "https://api.example.com", "OPENAPI_SPEC_PATH": "https://api.example.com/openapi.json", "API_HEADERS": "Authorization:Bearer token123,X-API-Key:your-api-key" } } } }

環境変数を実際の API 構成に置き換えます。
- API_BASE_URL : APIのベースURL
- OPENAPI_SPEC_PATH : OpenAPI 仕様への URL またはパス
- API_HEADERS : API認証ヘッダーのコンマ区切りのキーと値のペア

オプション 2: HTTP クライアント (HTTP トランスポート) で使用する

HTTP クライアントでサーバーを使用するには:

インストールは不要です！npx を使用してパッケージを直接実行します。

HTTP リクエストを使用してサーバーと対話します。

# Initialize a session (first request) curl -X POST http://localhost:3000/mcp \ -H "Content-Type: application/json" \ -d '{"jsonrpc":"2.0","id":0,"method":"initialize","params":{"client":{"name":"curl-client","version":"1.0.0"},"protocol":{"name":"mcp","version":"2025-03-26"}}}' # The response includes a Mcp-Session-Id header that you must use for subsequent requests # and the InitializeResult directly in the POST response body. # Send a request to list tools # This also receives its response directly on this POST request. curl -X POST http://localhost:3000/mcp \ -H "Content-Type: application/json" \ -H "Mcp-Session-Id: your-session-id" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' # Open a streaming connection for other server responses (e.g., tool execution results) # This uses Server-Sent Events (SSE). curl -N http://localhost:3000/mcp -H "Mcp-Session-Id: your-session-id" # Example: Execute a tool (response will arrive on the GET stream) # curl -X POST http://localhost:3000/mcp \ # -H "Content-Type: application/json" \ # -H "Mcp-Session-Id: your-session-id" \ # -d '{"jsonrpc":"2.0","id":2,"method":"tools/execute","params":{"name":"yourToolName", "arguments": {}}}' # Terminate the session when done curl -X DELETE http://localhost:3000/mcp -H "Mcp-Session-Id: your-session-id"

輸送タイプ

標準入出力トランスポート（デフォルト）

stdioトランスポートは、標準入出力を介してMCP接続を管理するClaude DesktopなどのAIシステムと直接統合するために設計されています。これは最もシンプルなセットアップであり、ネットワーク設定は必要ありません。

使用する場合: Claude Desktop または stdio ベースの MCP 通信をサポートする他のシステムと統合する場合。

ストリーミング可能なHTTPトランスポート

HTTPトランスポートにより、MCPサーバーにHTTP経由でアクセスすることが可能になり、Webアプリケーションやその他のHTTP対応クライアントがMCPプロトコルとやり取りできるようになります。セッション管理、ストリーミングレスポンス、標準HTTPメソッドをサポートしています。

主な機能:

Mcp-Session-Idヘッダーによるセッション管理
initializeおよびtools/list要求に対する HTTP 応答は、POST で同期的に送信されます。
その他のサーバーからクライアントへのメッセージ (例: tools/execute結果、通知) は、Server-Sent Events (SSE) を使用して GET 接続を介してストリーミングされます。
POST/GET/DELETEメソッドのサポート

使用する場合: MCP サーバーを、stdio ではなく HTTP 経由で通信する Web クライアントまたはシステムに公開する必要がある場合。

設定オプション

サーバーは、環境変数またはコマンドライン引数を使用して構成できます。

環境変数

API_BASE_URL - APIエンドポイントのベースURL
OPENAPI_SPEC_PATH - OpenAPI 仕様へのパスまたは URL
API_HEADERS - APIヘッダーのコンマ区切りのキーと値のペア
SERVER_NAME - MCP サーバーの名前 (デフォルト: "mcp-openapi-server")
SERVER_VERSION - サーバーのバージョン（デフォルト: "1.0.0"）
TRANSPORT_TYPE - 使用するトランスポートタイプ: "stdio" または "http" (デフォルト: "stdio")
HTTP_PORT - HTTPトランスポートのポート（デフォルト: 3000）
HTTP_HOST - HTTPトランスポートのホスト（デフォルト: "127.0.0.1"）
ENDPOINT_PATH - HTTPトランスポートのエンドポイントパス（デフォルト: "/mcp"）

コマンドライン引数

npx @ivotoby/openapi-mcp-server \ --api-base-url https://api.example.com \ --openapi-spec https://api.example.com/openapi.json \ --headers "Authorization:Bearer token123,X-API-Key:your-api-key" \ --name "my-mcp-server" \ --version "1.0.0" \ --transport http \ --port 3000 \ --host 127.0.0.1 \ --path /mcp

セキュリティに関する考慮事項

HTTPトランスポートは、DNSリバインディング攻撃を防ぐためにOriginヘッダーを検証します。
デフォルトでは、HTTPトランスポートはローカルホスト（127.0.0.1）にのみバインドされます。
他のホストに公開する場合は、追加の認証を実装することを検討してください

デバッグ

デバッグログを表示するには:

Claude Desktop で stdio トランスポートを使用する場合:
- ログはClaude Desktopのログに表示されます
HTTP トランスポートを使用する場合:
npx @ivotoby/openapi-mcp-server --transport http 2>debug.log

開発者向け

開発ツール

npm run build - TypeScriptソースをビルドする
npm run clean - ビルド成果物を削除します
npm run typecheck - TypeScript の型チェックを実行します
npm run lint - ESLint を実行する
npm run dev - ソースファイルを監視し、変更があったら再構築する
npm run inspect-watch - 変更時に自動リロードするインスペクターを実行します

開発ワークフロー

リポジトリをクローンする
依存関係をインストール: npm install
開発環境を起動します: npm run inspect-watch
src/内の TypeScript ファイルに変更を加える
サーバーは自動的に再構築され、再起動します

貢献

リポジトリをフォークする
機能ブランチを作成する
変更を加える
テストとリンティングを実行します: npm run typecheck && npm run lint
プルリクエストを送信する

ライセンス

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

OpenAPI MCP Server