OpenAPI MCP Server

OpenAPI MCP サーバー

これは、OpenAPI 仕様ファイルを読み込み、各 API 操作を Claude AI が使用できるツールとして公開する Model Context Protocol（MCP）サーバーです。

機能

• OpenAPI YAML ファイルを自動的に解析します
• 各 API 操作に対応する MCP ツールを生成します
• パスパラメーター、クエリパラメーター、リクエストボディを処理します
• Claude がツールを使用すると、ライブ API 呼び出しを行います
• Claude Desktop と簡単に統合できます

インストール

# Clone the repository
git clone https://github.com/yourusername/openapi-mcp-server.git
cd openapi-mcp-server

# Install dependencies
npm install

使用方法

1. OpenAPI YAML ファイルをプロジェクトディレクトリに配置するか、環境変数を使ってファイルへのパスを指定します。

2. 環境変数を設定します（任意）。

# Create a .env file
echo "DEBUG=true" > .env
echo "OPENAPI_FILE=./path/to/your/openapi.yaml" >> .env

3. Claude Desktop でサーバーを初期化します。

npm run init

4. または、サーバーを手動で実行します。

npm start

設定

環境変数を使ってサーバーを設定できます。

• DEBUG: デバッグログを有効にするには true に設定します（デフォルト：false）
• OPENAPI_FILE: OpenAPI YAML ファイルへのパス（デフォルト：./openapi.yaml）

仕組み

サーバーは OpenAPI 仕様ファイルを読み込み、次の処理を行います。

1. すべてのパスと操作を抽出します
2. 適切な入力スキーマを備えたツールを各操作に対して作成します
3. Claude がツールを呼び出すと、サーバーが対応する API リクエストを行います
4. 分析用にレスポンスを Claude に返します

例

次のような OpenAPI 仕様の場合：

paths:
  /users:
    get:
      operationId: listUsers
      summary: List all users
      ...

Claude は listUsers ツールを呼び出すことができ、サーバーが代わりに /users へ GET リクエストを行います。

ライセンス

MIT