OpenAPI MCP Server
MCP-сервер превращает операции OpenAPI в инструменты агента и отправляет реальные запросы к указанному REST API.
- 302 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Агент вызывает операции вашего API с переданными правами, включая изменение данных, если такие операции опубликованы.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/openapi-mcp-serverОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Агент вызывает операции вашего API с переданными правами, включая изменение данных, если такие операции опубликованы.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
OpenAPI MCP Server от ivo-toby читает спецификацию API и открывает ее операции агенту как инструменты. Пользователь задает адрес сервиса, источник описания и заголовки авторизации. Агент видит доступные действия и вызывает их с параметрами. Спецификация может быть файлом или URL. Сервер поддерживает локальное подключение клиента и отдельный HTTP-режим, а также выбор публикуемых инструментов. Дополнительно можно подключить подготовленные промпты и ресурсы, если клиент умеет их показывать.
Для кого. Разработчикам внутренних REST API, которые хотят подключить готовое описание OpenAPI к Claude Desktop или Cursor.
Подходит, если
- У сервиса есть OpenAPI, и агенту нужен доступ к его операциям.
- Для тестового API вы хотите быстро проверить вызов из чата.
- Из большой спецификации нужно показать агенту только выбранные инструменты.
- Одно подключение должно использовать локальную или удаленную спецификацию.
Не подходит, если
- Агенту нужен только справочник без возможности выполнить запрос.
- Спецификация описывает больше прав, чем допустимо выдать модели.
- У целевого сервиса нет корректного описания поддерживаемых операций.
Пример запроса к агенту
Подключи тестовую OpenAPI-спецификацию только для чтения списка объектов и покажи доступные инструменты до первого запроса.MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Ограничения
Сервер вызывает настоящий API, поэтому действия записи могут менять рабочие данные в пределах переданного токена. По умолчанию загружаются все операции; перед подключением ограничьте набор и проверьте права учетной записи. Описание должно соответствовать текущему API: устаревшая схема может привести к ошибке или неверным параметрам. Заголовки авторизации находятся в конфигурации процесса, поэтому защищайте этот файл и не передавайте его в сообщения или репозиторий.
Как отключить. Удалите соединение MCP и остановите сервер. Отзовите токен целевого API; выполненные операции и изменения данных проверяйте на стороне сервиса.
Частые вопросы
Нужно ли клонировать репозиторий?
Нет. Клиент может запускать опубликованный npm-пакет через npx.
Где указать спецификацию?
В `OPENAPI_SPEC_PATH`: подойдет путь к файлу или URL.
Как скрыть лишние операции?
Настройте фильтры и режим загрузки инструментов. По умолчанию выбран режим всех операций.
Почему клиент не показывает подготовленные подсказки?
Проверьте, поддерживает ли он промпты сервера и подключен ли файл этих подсказок.
Можно ли подключить внутренний API с клиентским сертификатом?
Да. Есть параметры сертификата, закрытого ключа и доверенного CA для взаимной TLS-аутентификации.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыOpenMCP превращает любую OpenAPI-спецификацию в MCP-сервер и дает выбрать, какие инструменты показывать агенту
CLI собирает готовый MCP-сервер на TypeScript из спецификации OpenAPI 3: инструменты, валидация и авторизация генерируются сами
Шлюз, который превращает любой API с описанием OpenAPI V3 в MCP-сервер, без правки исходного API
MCP-сервер, который дает агенту читать файлы, искать по коду и запускать команды в рабочей папке
CLI openmcp и расширение VS Code для отладки MCP-серверов: проверка инструментов, промптов и ресурсов, чат с моделью, тесты
Плагин со скиллами для сборки MCP-серверов и MCP-приложений на TypeScript: агент создает, дорабатывает, отлаживает и проверяет их
Коротко о README
Адрес HTTP-сервера по умолчанию привязан к 127.0.0.1. Для имен инструментов предусмотрена обработка длинных названий.