mockzilla-mcp — MCP-сервер для Claude Code: моки API по OpenAPI
Поднимает локальные моки по спецификациям OpenAPI и разворачивает хостинговые на mockzilla.org. Агент устанавливает CLI, линтит спеки, генерирует Go-код и управляет запущенными серверами.
MIT ★ 7 обновлён 2026-10-09
claude mcp add --env MOCKZILLA_TOKEN=<MOCKZILLA_TOKEN> --env MOCKZILLA_MCP_URL=<MOCKZILLA_MCP_URL> --env MOCKZILLA_MANAGED_PORT=<MOCKZILLA_MANAGED_PORT> --transport stdio mockzilla-mcp -- npx -y @mockzilla/mcpЧто делает mockzilla-mcp
Сервер работает в двух режимах. Локально запускает моки без регистрации: агент проверяет наличие CLI, устанавливает его в кеш, читает спеки и .mockz-архивы, упрощает тяжёлые схемы, генерирует модели и серверы на Go для 14 роутеров, поднимает mock-сервер и возвращает эндпоинты. Линтовка находит схемы, которым не соответствует ни одно значение, — это ловит сломанную спеку до запуска.
Хостинговый режим включается после однократного логина через браузер: агент получает доступ к организации и может деплоить моки из спеки, URL или каталога, листить запущенные симы и ждать, пока развёртывание завершится. Мокать можно платёжные API (Stripe, PayPal, Adyen), криптобиржи (Binance, Bybit) и сервисы с лимитами (OpenAI, Twilio) — без тестовых аккаунтов и квот. CLI ставится в ~/.cache/mockzilla-mcp/ и не трогает системный PATH.
npx с флагом @latest проверяет реестр при каждом запуске: перезапуск платформы подхватывает свежую версию, но добавляет около 200 миллисекунд к старту.
Какие задачи решает
- поднять мок Stripe или Binance без регистрации и тестового аккаунта
- линтовать OpenAPI-спеку и найти схемы, которым не соответствует ни одно значение
- сгенерировать Go-модели, сервер и клиент из спецификации
- развернуть хостинговый мок на mockzilla.org из редактора
- мокать один HTTP-эндпоинт без полной спеки
Примеры запросов агенту
- Установи CLI Mockzilla в кеш
- Подними локальный мок по
petstore.yamlи дай мне эндпоинты - Залогинь меня в Mockzilla и разверни хостинговый мок Stripe с именем
stripe-test
Как установить mockzilla-mcp
Командой платформы
claude mcp add --env MOCKZILLA_TOKEN=<MOCKZILLA_TOKEN> --env MOCKZILLA_MCP_URL=<MOCKZILLA_MCP_URL> --env MOCKZILLA_MANAGED_PORT=<MOCKZILLA_MANAGED_PORT> --transport stdio mockzilla-mcp -- npx -y @mockzilla/mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add mockzilla-mcp --env MOCKZILLA_TOKEN=<MOCKZILLA_TOKEN> --env MOCKZILLA_MCP_URL=<MOCKZILLA_MCP_URL> --env MOCKZILLA_MANAGED_PORT=<MOCKZILLA_MANAGED_PORT> -- npx -y @mockzilla/mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"mockzilla-mcp": {
"command": "npx",
"args": [
"-y",
"@mockzilla/mcp"
],
"env": {
"MOCKZILLA_TOKEN": "<MOCKZILLA_TOKEN>",
"MOCKZILLA_MCP_URL": "<MOCKZILLA_MCP_URL>",
"MOCKZILLA_MANAGED_PORT": "<MOCKZILLA_MANAGED_PORT>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"mockzilla-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@mockzilla/mcp"
],
"env": {
"MOCKZILLA_TOKEN": "<MOCKZILLA_TOKEN>",
"MOCKZILLA_MCP_URL": "<MOCKZILLA_MCP_URL>",
"MOCKZILLA_MANAGED_PORT": "<MOCKZILLA_MANAGED_PORT>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e MOCKZILLA_TOKEN=<MOCKZILLA_TOKEN> -e MOCKZILLA_MCP_URL=<MOCKZILLA_MCP_URL> -e MOCKZILLA_MANAGED_PORT=<MOCKZILLA_MANAGED_PORT> mockzilla-mcp npx -y @mockzilla/mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mockzilla-mcp
Как установить mockzilla-mcp в Claude Code?
Выполни claude mcp add mockzilla-mcp -e MOCKZILLA_TOKEN=<MOCKZILLA_TOKEN> -- npx -y @mockzilla/mcp. Токен нужен только для хостинговых моков; локальные работают без него.
Что делает mockzilla-mcp?
Поднимает локальные mock-серверы по OpenAPI-спецификациям, линтует схемы, генерирует Go-код и деплоит хостинговые моки на mockzilla.org после логина.
Зачем нужен флаг @latest в команде npx?
Без него npx закеширует первую версию и не обновится. С @latest каждый перезапуск платформы подхватывает свежий пакет из реестра, но старт занимает на 200 миллисекунд дольше.