Swagger/OpenAPI仕様ファイルから直接MCPツール定義を生成してください。

OpenAPI-MCPは、swagger.jsonまたはopenapi.yamlファイルを読み取り、対応するモデルコンテキストプロトコル(MCP)ツールセットを生成するドッカー化されたMCPサーバーです。これにより、CursorのようなMCP互換クライアントが標準のOpenAPI仕様で説明されたAPIとやり取りできます。これで、AIエージェントはOpenAPI/Swagger仕様を提供するだけで、追加のコーディングは不要です。

目次

• なぜOpenAPI-MCPなのか?
• 特徴
• 設置
• 事前に構築されたDocker Hubイメージの使用(推奨)
• ローカル建築(任意)
• ウェザービット例の実行(ステップバイステップ)
• コマンドラインオプション
• 環境変数

デモ

自分でデモを実行してみてください:Weatherbitの例を走らせる(ステップバイステップ)

なぜOpenAPI-MCPなのか?

• 標準準拠: 既存のOpenAPI/Swaggerドキュメントを活用しましょう。
• 自動ツール生成: 各エンドポイントごとに手動設定せずにMCPツールを作成できます。
• 柔軟なAPIキーハンドリング: プロキシAPIのAPIキー認証をMCPクライアントに公開せずに安全に管理できます。

OpenAPI-MCP: Dockerized MCP Server to allow your AI agent to access any API with existing api docs

Generate MCP tool definitions directly from a Swagger/OpenAPI specification file.

OpenAPI-MCP is a dockerized MCP server that reads a swagger.json or openapi.yaml file and generates a corresponding Model Context Protocol (MCP) toolset. This allows MCP-compatible clients like Cursor to interact with APIs described by standard OpenAPI specifications. Now you can enable your AI agent to access any API by simply providing its OpenAPI/Swagger specification - no additional coding required.

Table of Contents

• Why OpenAPI-MCP?
• Features
• Installation
  • Using the Pre-built Docker Hub Image (Recommended)
  • Building Locally (Optional)
• Running the Weatherbit Example (Step-by-Step)
• Command-Line Options
  • Environment Variables

Demo

Run the demo yourself: Running the Weatherbit Example (Step-by-Step)

Why OpenAPI-MCP?

• Standard Compliance: Leverage your existing OpenAPI/Swagger documentation.
• Automatic Tool Generation: Create MCP tools without manual configuration for each endpoint.
• Flexible API Key Handling: Securely manage API key authentication for the proxied API without exposing keys to the MCP client.
• Local & Remote Specs: Works with local specification files or remote URLs.
• Dockerized Tool: Easily deploy and run as a containerized service with Docker.

Features

• OpenAPI v2 (Swagger) & v3 Support: Parses standard specification formats.
• Schema Generation: Creates MCP tool schemas from OpenAPI operation parameters and request/response definitions.
• Secure API Key Management:
  • Injects API keys into requests (header, query, path, cookie) based on command-line configuration.