Перейти к содержимому

MCP OpenAPI Schema Explorer

Сервер для токеноэффективного доступа к OpenAPI и Swagger спецификациям через ресурсы, без полной загрузки в контекст LLM.

TypeScript
52 stars

Описание

MCP OpenAPI Schema Explorer — сервер на Node.js для изучения структуры OpenAPI v3.0 и Swagger v2.0 (с автоматической конвертацией). Предоставляет доступ к частям спецификаций через MCP Resources с URI вроде openapi://paths/{path}/{method}. Поддерживает локальные файлы и URL. Идеален для клиентов вроде Claude Desktop: экономит токены, позволяет исследовать API без перегрузки. Технологии: NPM, Docker. Применения: анализ API, документация, разработка.

Возможности

Доступ через MCP Resources

Изучение OpenAPI с URI: openapi://{field}, openapi://paths/{path}/{method*}, openapi://components/{type}/{name*}.

Поддержка форматов

OpenAPI v3.0 и Swagger v2.0 с автоматической конвертацией в v3.0.

Загрузка спецификаций

Из локальных файлов или HTTP/HTTPS URL.

Экономия токенов

Предоставляет структурированный доступ без загрузки всего файла в LLM.

Форматы вывода

JSON (по умолчанию), YAML, minified JSON.

Трансформация ссылок

Преобразует $ref в кликабельные MCP URI.

Установка

Рекомендуемый способ — npx без установки:

{ “mcpServers”: { “My API Spec (npx)”: { “command”: “npx”, “args”: [ “-y”, “mcp-openapi-schema-explorer@latest”, “”, “–output-format”, “yaml” ], “env”: {} } } }

Для Docker (удаленный URL):

{ “mcpServers”: { “My API Spec (Docker Remote)”: { “command”: “docker”, “args”: [ “run”, “–rm”, “-i”, “kadykov/mcp-openapi-schema-explorer:latest”, “” ], “env”: {} } } }

Глобальная установка: npm install -g mcp-openapi-schema-explorer

Информация

Язык
TypeScript
Лицензия
MIT License
GitHub Stars
52

Ссылки