swagger-mcp

swagger-mcp — инструмент для динамической генерации инструментов из Swagger/OpenAPI спецификаций на runtime.

⭐ 65 stars

Описание

swagger-mcp — сервер на Go, который извлекает swagger.json из Swagger UI и генерирует инструменты для MCP-клиентов динамически. Поддерживает аутентификацию (basic, apiKey, bearer), режимы SSE и stdio, переопределение базового URL. Идеален для интеграции API в LLM-системы без ручного создания инструментов, минимизируя галлюцинации и обеспечивая точные вызовы на основе API-ответов. Применяется в AI-агентах для автоматизации работы с внешними сервисами.

Возможности

✓

Динамическая генерация инструментов

Извлечение swagger.json и создание инструментов на основе OpenAPI спецификаций для MCP-клиентов.

✓

Поддержка аутентификации

Basic auth, bearer токены, API-ключи в header/query/cookie для безопасного доступа к API.

✓

Режимы запуска

SSE-сервер для потоковой передачи или stdio для стандартного ввода/вывода.

✓

Интеграция с LLM

Работа с OpenAI, Claude или Ollama для автоматизированных вызовов API без галлюцинаций.

✓

Конфигурируемые флаги

Переопределение baseUrl, specUrl, sseAddr для гибкой настройки под разные API.

Установка

Установка:

go install github.com/danishjsheikh/swagger-mcp@latest
swagger-mcp --specUrl=https://your_swagger_api_docs.json

Конфигурация для MCP (.mcp.json):

{
    "mcpServers": {
        "swagger_loader": {
            "command": "swagger-mcp",
            "args": ["--specUrl=<swagger/doc.json_url>"]
        }
    }
}

Требования: LLM API-ключ или локальный LLM (Ollama), MCP-клиент (например, mcphost).

Информация

Язык

Лицензия

MIT License

GitHub Stars

Ссылки

GitHub