mockserver — MCP-сервер для Claude Code: моки и запись трафика
Поднимает один порт, который отвечает за любую внешнюю зависимость: HTTP, gRPC, WebSocket. Пригодится, когда бэкенда ещё нет или он падает.
Открыть на GitHubЧто делает mockserver
MockServer запускается как отдельный процесс и слушает порт 1080. Дальше вы описываете ожидания через REST control plane на том же порту: метод, путь, заголовки, тело. Ответ можно вернуть готовый, собранный по шаблону или вычисленный колбэком.
Внутри — прокси с записью и воспроизведением трафика, включая расшифровку TLS. Есть режим инъекции задержек, обрывов соединения и ошибок, чтобы проверить, как приложение переживает сбой зависимости. Отдельно мокаются chat-completion API OpenAI, Anthropic, Gemini, Bedrock, Azure OpenAI и Ollama, в том числе со стримингом.
Запускается через docker run -d --rm -p 1080:1080 mockserver/mockserver, есть установка через Homebrew и Helm. Клиентские библиотеки — для Java, Node, Python, Ruby, Go, .NET, Rust и PHP. Без запущенного процесса на порту 1080 ни одна команда через MCP не сработает, потому что сервер только управляет уже поднятым MockServer.
Какие задачи решает
- поднять мок REST-эндпоинта, пока бэкенд не готов
- записать реальный трафик и воспроизвести его в тестах
- проверить поведение приложения при обрыве соединения с зависимостью
- сгенерировать моки из OpenAPI-спеки вместо ручного описания
- подменить ответы chat-completion API при отладке агента
Примеры запросов агенту
- Подними MockServer на порту 1080 и замокай GET /hello с ответом 200
- Запиши трафик через прокси и покажи, какие запросы ушли на бэкенд
- Добавь задержку 3 секунды на все запросы к /pets и прогони тесты
Как установить mockserver
Установка
Команды запуска нет в реестре MCP — смотрите README репозитория
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mockserver
Как установить mockserver в Claude Code?
Готовой команды установки для Claude нет. MockServer поднимают отдельно: docker run -d --rm -p 1080:1080 mockserver/mockserver, затем подключают MCP-сервер к ассистенту.
Что делает mockserver?
Мокает, записывает и воспроизводит трафик к внешним зависимостям, а ещё умеет injectить задержки и ошибки. Управление идёт через REST control plane на том же порту.
Какие протоколы поддерживает mockserver?
HTTP/1.1, HTTPS, HTTP/2, gRPC и gRPC-Web, WebSockets, raw TCP, экспериментальный HTTP/3. Протокол определяется по первым байтам соединения.
