mcpField
S
Swagger MCP Server

Swagger MCP Server

ローカル
github.com/marcin-sucharski開発ツール019 週間前に更新
リポジトリ

Swagger MCP Server について

Swagger MCP Serverは、Swagger/OpenAPIで定義されたAPIをMCP経由でAIエージェントに公開します。開発者は設定ファイルで公開するエンドポイントを指定できます。

主な機能

  1. 01Swagger/OpenAPI APIの公開
  2. 02JSONによるエンドポイント設定
  3. 03複数エンドポイントへの対応

活用シーン

  1. 01AIエージェントへのSwagger API提供
  2. 02MCPで使うAPI定義の設定

MCP 対応

設定したSwagger/OpenAPI APIをMCPクライアントに公開するMCPサーバーです。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "swagger-mcp-server-marcin-sucharski": {
      "command": "npx",
      "args": [
        "-y",
        "swagger-mcp-server"
      ]
    }
  }
}
起動コマンドnpx -y swagger-mcp-server

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npmswagger-mcp-server

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

Swagger MCP サーバー

Swagger/OpenAPI エンドポイント向けの Model Context Protocol サーバーです。このツールを使用すると、Swagger で定義された API を Model Context Protocol 経由で公開し、AI エージェントから利用できるようになります。

インストール

パッケージをグローバルにインストールできます。

npm install -g swagger-mcp-server

または、npx を使って直接実行できます。

npx swagger-mcp-server <config-file>

使い方

  1. 公開する Swagger エンドポイントを定義した設定ファイル（JSON）を作成します。
{
  "endpoints": [
    {
      "name": "example-api",
      "url": "https://example.com/api/swagger.json"
    }
  ]
}
  1. サーバーを実行します。
swagger-mcp-server config.json

または、npx を使って実行します。

npx swagger-mcp-server config.json

設定オプション

設定ファイルでは、次のオプションを指定できます。

  • endpoints：公開する Swagger エンドポイントの配列
    • name：エンドポイントの一意な識別子
    • url：Swagger/OpenAPI JSON 定義の URL

開発

プロジェクトをビルドするには、次のコマンドを実行します。

npm run build

ローカルで実行するには、次のコマンドを実行します。

npm run run

ライセンス

ISC

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。