Генерируйте определения инструментов MCP непосредственно из файла спецификаций Swagger/OpenAPI.

OpenAPI-MCP — это докеризованный MCP-сервер, который читает файлы swagger.json или openapi.yaml и генерирует соответствующий набор инструментов Model Context Protocol (MCP). Это позволяет совместимым с MCP клиентам, таким как Cursor, взаимодействовать с API, описанными стандартными спецификациями OpenAPI. Теперь вы можете разрешить своему AI-агенту доступ к любому API, просто указав его спецификацию OpenAPI/Swagger — дополнительное кодирование не требуется.

Содержание

• Почему OpenAPI-MCP?
• Особенности
• Установка
• Использование готового образа Docker Hub (рекомендуется)
• Локальное строительство (необязательно)
• Пример запуска Weatherbit (пошагово)
• Опции командной строки
• Переменные среды

Демо

Проведите демонстрацию самостоятельно: Пример с 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.