Hoverfly — MCP-сервер для Claude Code: возможности и установка
Сервер подключает Hoverfly к ИИ-ассистенту и позволяет управлять моками API. Он пригодится, когда внешний сервис недоступен во время разработки или тестирования.
лицензия не указана обновлён 2026-10-29
Открыть на GitHubЧто делает Hoverfly
Через MCP- инструменты ассистент может запустить и остановить Hoverfly, проверить его состояние, посмотреть активные моки и добавить новый по JSON-описанию пары запрос–ответ. Есть инструменты для документации Hoverfly, подсказок по матчерам и отладки по логам. Это управление моками через запросы к ассистенту, а не ручное редактирование каждого ответа в коде.
Сервер запускается в Docker и использует порт 8500 для прокси и 8888 для административного API. Чтобы симуляции переживали перезапуск, подключите доступный для записи каталог к /opt/hoverfly-mcp/simulation-data: другого места для постоянных данных сервер не поддерживает. Файлы сохраняются туда при вызове download_hoverfly_simulation; при запуске Hoverfly может загрузить последнюю симуляцию из каталога. Для сборки из исходников нужны Java 17 и Maven 3.6+.
Какие задачи решает
- подменить ответ внешнего API во время разработки
- добавить мок API по паре запрос–ответ в JSON
- проверить, какие моки сейчас активны
- сохранить симуляцию Hoverfly между перезапусками
- получить логи Hoverfly для отладки
Примеры запросов агенту
- Запусти Hoverfly в режиме симуляции и проверь его состояние.
- Добавь мок API по этому JSON с парой запроса и ответа.
- Сохрани текущую симуляцию Hoverfly в каталог данных.
Как установить Hoverfly
Установка
Команды запуска нет в реестре MCP — смотрите README репозитория
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Hoverfly
Как установить Hoverfly в Claude Code?
Добавьте в .mcp.json конфигурацию MCP-сервера с командой docker и образом docker.io/kapish88/hoverfly-mcp-server. В аргументах запуска укажите порты 8500 и 8888, а для сохранения симуляций подключите каталог к /opt/hoverfly-mcp/simulation-data; Docker должен быть установлен.
Что делает Hoverfly?
Он подключает инструменты Hoverfly к ИИ-ассистенту через MCP. Ассистент может запускать сервер и управлять моками API, чтобы тестировать интеграцию без доступного внешнего сервиса.
Где сохраняются симуляции Hoverfly?
Для постоянного хранения подключите записываемый каталог к /opt/hoverfly-mcp/simulation-data внутри контейнера. Симуляция сохраняется туда при вызове download_hoverfly_simulation, а при запуске Hoverfly может загрузить оттуда последнюю сохранённую симуляцию.