OpenAPI to MCP Server
Автоматически конвертирует спецификации OpenAPI в конфигурации Higress MCP серверов.
Описание
Инструмент на Go для преобразования OpenAPI (JSON/YAML) в конфигурации MCP серверов для Higress. Генерирует инструменты из путей API, сохраняет параметры, типы и описания. Поддерживает схемы безопасности, шаблоны для кастомизации, валидацию и MCP Protocol 2025-06-18 с выходными схемами и структурированным контентом. Идеален для интеграции REST API в AI-приложения Higress, упрощая создание инструментов для LLM.
Возможности
Конвертация OpenAPI в MCP
Преобразует пути API в MCP-инструменты с автоматическим определением позиций параметров (path, query, body и т.д.).
Поддержка форматов
Работает с JSON и YAML спецификациями OpenAPI, генерирует YAML/JSON конфигурации.
Генерация шаблонов ответов
Создает responseTemplate с описаниями полей для лучшего понимания LLM.
Схемы безопасности
Конвертирует securitySchemes и requirements в MCP-формат для аутентификации.
Шаблонная кастомизация
Использует --template для добавления заголовков, аутентификации или общих настроек.
Поддержка MCP 2025-06-18
Генерирует outputSchema и структурированный контент для новых клиентов MCP.
Валидация спецификаций
Опциональная проверка OpenAPI на корректность перед конвертацией.
Установка
Установка:
go install github.com/higress-group/openapi-to-mcpserver/cmd/openapi-to-mcp@latest
Использование:
openapi-to-mcp --input path/to/openapi.json --output path/to/mcp-server.yaml
Опции: –server-name, –tool-prefix, –format (yaml/json), –validate, –template.