Swagger MCP Server
Сервер для загрузки и обслуживания Swagger/OpenAPI спецификаций с генерацией API-инструментов.
Описание
Это Node.js-сервер на TypeScript, который интегрирует Swagger/OpenAPI спецификации в Model Context Protocol (MCP). Ключевые особенности: автоматическая генерация инструментов из API-эндпоинтов, поддержка аутентификации (Basic Auth, Bearer Token, API Key, OAuth2), SSE для реального времени. Идеален для личного использования в разработке, тестировании API или интеграции моделей ИИ с внешними сервисами. Не предназначен для публичного доступа из-за соображений безопасности.
Возможности
Загрузка спецификаций
Загружает Swagger/OpenAPI из файла или URL, используя настройки из спецификации как приоритет.
Поддержка аутентификации
Интеграция Basic Auth, Bearer Token, API Key (header/query), OAuth2 с fallback из config.json.
Генерация инструментов
Автоматически создаёт MCP-инструменты из API-эндпоинтов для удобного доступа.
SSE-поддержка
Server-Sent Events для реального времени коммуникации через /sse.
Эндпоинты сервера
Здоровье (/health), сообщения (/messages) и SSE-соединения для MCP-взаимодействия.
Установка
- Клонируйте репозиторий: git clone https://github.com/dcolley/swagger-mcp.git && cd swagger-mcp
- Установите зависимости: yarn install
- Создайте .env: cp .env.example .env
- Разместите Swagger-файл (swagger.json) или укажите URL.
- Настройте config.json с хостом, портом, Swagger URL и аутентификацией.
- Запустите: yarn dev (для разработки) или yarn build && yarn start (для продакшена). Требования: Node.js v18+, Yarn, TypeScript.