OpenAPI-MCP

Установка

Работает в

• Claude Code
• Claude Desktop
• Cursor
• SourceCraft
• Koda
• Coddy

Ручная установка

pip install 'openapi-mcp-proxy==2.0.0rc1'

Что делает

OpenAPI-MCP читает документ OpenAPI, локальный JSON или YAML либо адрес HTTP(S), и открывает его операции как инструменты MCP. Кроме инструментов он отдает ресурсы схем и подсказку по использованию. Транспорт по умолчанию stdio, есть Streamable HTTP на `/mcp` и старый SSE по явной настройке. Каждая операция превращается в инструмент с именем `<сервер>_<operationId>`, входные данные проверяются по схеме до запроса, тело JSON передается аргументом `body`. По умолчанию наружу не выставлено ни одной операции. Нужные задаются в `MCP_ALLOWED_OPERATIONS` как массив пар вроде `GET /pets`, совпадение буквальное, неверный список останавливает запуск. Режим `MCP_OPERATION_POLICY=all` открывает все. Каждый инструмент принимает `dry_run: true` и возвращает подготовленный запрос без выполнения. Авторизация исходящих вызовов идет через `MCP_AUTH_HEADERS` или клиентские данные OAuth.

Для кого. Разработчикам, которые дают агенту доступ к своему или чужому REST API по описанию OpenAPI и хотят ограничить набор операций.

Пример запроса к агенту

Подними OpenAPI-MCP для petstore.json так, чтобы агенту были доступны только GET /pets и GET /pets/{petId}

MCP

Транспорт

stdio, http, sse

Авторизация

ключ необязателен

Ограничения

Версия `2.0.0rc1` остается кандидатом в релиз, а версия 1.0.4 этих исправлений не содержит, перед обновлением нужно прочитать руководство по переходу. Нужен Python 3.10 или новее. Политика операций действует на весь экземпляр сервера и ни на кого по отдельности, а список только на GET не гарантирует безвредность маршрутов. Учетные данные идут на исходящие вызовы, поэтому нужны ограниченные ключи API. Адрес по умолчанию для HTTP сменился с `/sse` на `/mcp`, клиентов нужно обновить.

Как отключить. Удалите запись сервера из конфигурации клиента и выполните `pip uninstall openapi-mcp-proxy` в окружении, где он стоял.

Коротко о README

В README описана установка кандидата 2.0.0rc1, запуск и настройку клиента для stdio и Streamable HTTP. Затем раздел о выборе открываемых операций, о предпросмотре запросов, таблица переменных окружения, сведения об авторизации исходящих вызовов и проверках.