MCP OpenAPI Schema Explorer — чтение спецификаций
MCP OpenAPI Schema Explorer даёт ассистенту читать отдельные части спецификаций OpenAPI и Swagger через шаблоны ресурсов MCP.
Ручной проверки с опубликованным протоколом у этой записи нет. Владелец сервера может заказать её.
Собранные проверки · 03.10.2026
Сохранённый прогон по данным каталога; пропущенные пункты не считаются выполненными. Это не испытание сервера в работе.
- repo_aliveGitHub отдал карточку репозитория. (выполнено) · Источник(откроется в новой вкладке)
- recent_activityКод меняли за последние 365 дней. (выполнено)
- package_existsПакет не заявлен. (пропущено)
- licenseЛицензия MIT. (выполнено)
- name_spoofingПохожего более известного имени другого владельца нет. (выполнено)
- secretsREADME и архив пакета в этом прогоне не скачивали. В тексте описания ключа не видно. (пропущено)
- install_resolvesКоманду установки на странице ещё не показываем. (пропущено)
- install_scriptПакета нет. (пропущено)
Когда полезен
kadykov/mcp-openapi-schema-explorer закрывает следующие сценарии, когда подключён к AI-агенту через Model Context Protocol:
- Ассистенту нужно разобраться в большой спецификации без чтения целого документа.
- Вы хотите посмотреть параметры метода или описание отдельной схемы данных.
Что умеет kadykov/mcp-openapi-schema-explorer
Сервер загружает спецификации OpenAPI из локального файла или по HTTP/HTTPS. Поддерживает OpenAPI 3.0 и Swagger 2.0; документ Swagger преобразует при загрузке. Клиент получает шаблоны URI для просмотра сведений об API, путей, методов и компонентов. Можно запросить описание отдельной операции или схемы, не передавая весь документ в контекст модели. Ответы доступны в JSON, YAML и сокращённом JSON. Здесь читают описание API: просмотр метода не означает выполнение запроса к сервису, который этот метод предоставляет.
Ограничения
Клиент должен поддерживать MCP Resource Templates. Сервер читает описание API; чтобы выполнить запрос к самому сервису, нужен отдельный инструмент.
Как установить
Для чтения спецификаций клиент должен поддерживать MCP Resource Templates.
Укажите пакет mcp-openapi-schema-explorer и путь либо URL документа в конфигурации MCP-клиента. Для нескольких спецификаций добавьте отдельные записи. Обнаружение шаблонов выполняется через resources/templates/list.
Часто задаваемые вопросы
- Можно ли читать локальные спецификации OpenAPI?
- Да, сервер принимает путь к локальному файлу либо HTTP/HTTPS-адрес документа. Поддерживаются OpenAPI 3.0 и Swagger 2.0, причём Swagger преобразуется при загрузке. Для нескольких документов добавьте отдельные записи конфигурации, каждую со своим источником и именем подключения.
- Почему resources/list возвращает пустой список?
- Сервер предоставляет шаблоны ресурсов, а не заранее перечисленные ресурсы. Клиент вызывает resources/templates/list, заполняет параметры выбранного URI и получает содержимое через resources/read. Поэтому пустой ответ обычного списка сам по себе не означает ошибку загрузки или отсутствие документа.
- Выполняет ли просмотр метода запрос к описанному сервису?
- Нет, ресурс для пути и метода возвращает сведения об операции из спецификации. Вы получите описание параметров и ответов, а не данные самого сервиса. Для обращения к сервису используйте отдельный инструмент HTTP-запросов с нужным адресом и авторизацией.
- В каком формате приходят ответы?
- Формат задаётся параметром --output-format: JSON, YAML или сокращённый JSON. Некоторые ресурсы, перечисляющие пути или методы, возвращают текстовый список. Выберите представление под свой клиент: формат меняет вид данных из спецификации OpenAPI, а не способ обращения к описанному сервису.