hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

OpenAPI MCP サーバー

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

クイックスタート

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

Claude Desktop 構成ファイルを見つけるか作成します。
- macOSの場合: ~/Library/Application Support/Claude/claude_desktop_config.json
OpenAPI MCP サーバーを有効にするには、次の構成を追加します。

{
  "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認証ヘッダーのコンマ区切りのキーと値のペア

開発ツール

このプロジェクトには、ワークフローを容易にするいくつかの開発ツールが含まれています。

建物

npm run build - TypeScriptソースをビルドする
npm run clean - ビルド成果物を削除します
npm run typecheck - TypeScript の型チェックを実行します

開発モード

npm run dev - ソースファイルを監視し、変更があったら再構築する
npm run inspect-watch - 変更時に自動リロードするインスペクターを実行します

コード品質

npm run lint - ESLint を実行する
npm run typecheck - TypeScriptの型を検証します

構成

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

環境変数

API_BASE_URL - APIエンドポイントのベースURL
OPENAPI_SPEC_PATH - OpenAPI 仕様へのパスまたは URL
API_HEADERS - APIヘッダーのコンマ区切りのキーと値のペア
SERVER_NAME - MCP サーバーの名前 (デフォルト: "mcp-openapi-server")
SERVER_VERSION - サーバーのバージョン（デフォルト: "1.0.0"）

コマンドライン引数

npm run inspect -- \
  --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"

開発ワークフロー

開発環境を起動します。

npm run inspect-watch

src/内の TypeScript ファイルに変更を加える
サーバーは自動的に再構築され、再起動します
MCP Inspector UI を使用して変更をテストします

デバッグ

サーバーはデバッグログをstderrに出力します。これらのログを確認するには、以下の手順を実行してください。

開発モードの場合:
- ログはinspect-watchを実行するターミナルに表示されます。
直接実行する場合:
npm run inspect 2>debug.log

貢献

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

ライセンス

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

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

大規模言語モデルがモデルコンテキストプロトコルを通じて OpenAPI 仕様で定義された REST API を検出し、対話できるようにするサーバー。

Related Resources

Reddit Discussion about this server

OpenAPI MCP Server