# mockzilla-mcp

Поднимает локальные моки по спецификациям OpenAPI и разворачивает хостинговые на mockzilla.org. Агент устанавливает CLI, линтит спеки, генерирует Go-код и управляет запущенными серверами.

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

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `MOCKZILLA_TOKEN`, `MOCKZILLA_MCP_URL`, `MOCKZILLA_MANAGED_PORT` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

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

**Командой платформы**
```bash
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

**Командой платформы**
```bash
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
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "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>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "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 CLI

**Командой платформы**
```bash
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
```
Вместо <…> подставьте свои значения

## Когда брать
- поднять мок Stripe или Binance без регистрации и тестового аккаунта
- линтовать OpenAPI-спеку и найти схемы, которым не соответствует ни одно значение
- сгенерировать Go-модели, сервер и клиент из спецификации
- развернуть хостинговый мок на mockzilla.org из редактора
- мокать один HTTP-эндпоинт без полной спеки

## Примеры запросов агенту
- Установи CLI Mockzilla в кеш
- Подними локальный мок по `petstore.yaml` и дай мне эндпоинты
- Залогинь меня в Mockzilla и разверни хостинговый мок Stripe с именем `stripe-test`

## Похожие
- [agent-ready-mpp](https://affpapa.org/nevibecode/skills/agent-ready-mpp.md) — скилл · ★ 141 у репозитория
- [stripe-best-practices](https://affpapa.org/nevibecode/skills/stripe-best-practices-2.md) — скилл · 102700 установок
- [stripe](https://affpapa.org/nevibecode/skills/vercel-labs-stripe.md) — скилл · 294 установки
- [api-mock](https://affpapa.org/nevibecode/commands/api-mock.md) — команда · ★ 42780 у репозитория
- [payment-testing](https://affpapa.org/nevibecode/rules/payment-testing.md) — правило · ★ 1216 у репозитория
- [stripe-integration-expert](https://affpapa.org/nevibecode/skills/stripe-integration-expert.md) — скилл · 612 установок

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