# OpenAPI Toolkit

MCP-сервер OpenAPI Toolkit с инструментами для OpenAPI и Swagger: перечисляет операции, проверяет спецификацию и собирает cURL по нужному operation ID.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Автор: lepoco
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/lepoco/openapi.client
- Обновлён: 2026-10-29
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/mcp/openapi-toolkit

## Что делает

OpenAPI Toolkit — MCP-сервер в контейнере: агент спрашивает у него про свою спецификацию, а сервер отвечает по делу. `get_list_of_operations` выдаёт operation ID из документа, `get_known_responses` показывает описанные ответы, `validate_document` проверяет структуру. Ещё два инструмента собирают код: `generate_curl_command` и `create_csharp_snippet`.

Запуск через Docker. Образ собирается командой `docker buildx build ./ -t mcp/openapi --no-cache`, после чего сервер прописывается в `.mcp.json` как `docker run -i --rm mcp/openapi`. Нужен HTTP-режим — тот же образ стартует с `-e MODE=Http -p 64622:8080`.

Docker на машине обязателен: без него клиент не поднимет контейнер и инструменты не появятся. Заготовка на C# полезна в .NET-проекте, в другом стеке работают cURL и проверка спецификации.

## Требования
- Нужно: Docker

## Установка

### Claude Code (родная платформа)

**Установка**
- Команды запуска нет в реестре MCP — смотрите README репозитория

## Когда брать
- найти все operation ID в большой спецификации
- проверить структуру OpenAPI перед коммитом
- собрать cURL для нужной операции без ручного набора
- посмотреть, какие ответы описаны у операции
- получить C#-заготовку HTTP-запроса по operation ID

## Примеры запросов агенту
- Перечисли все operation ID из `google.youtube.api.json` и собери cURL для создания заказа.
- Проверь `google.youtube.api.json` на ошибки в структуре OpenAPI.
- Какие ответы объявлены у операции `getUser`?

## Похожие
- [route-to-openapi](https://affpapa.org/nevibecode/skills/route-to-openapi.md) — скилл · ★ 4719 у репозитория
- [spring-boot-openapi-documentation](https://affpapa.org/nevibecode/skills/spring-boot-openapi-documentation.md) — скилл · 4200 установок
- [openapi-generator](https://affpapa.org/nevibecode/skills/openapi-generator.md) — скилл · 320 установок
- [openapi-expert](https://affpapa.org/nevibecode/skills/openapi-expert.md) — скилл · 282 установки
- [openapi](https://affpapa.org/nevibecode/skills/oakoss-openapi.md) — скилл · 197 установок

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
