@mockzilla/mcp

MCP-сервер для mockzilla. Позволяет таким агентам, как Claude Desktop и Cursor, управлять mockzilla от имени пользователя, а также помогает пользователям попробовать mockzilla без предварительной регистрации.

Мост предоставляет два уровня инструментов:

• Локальный уровень (без учетной записи): проверка установки CLI mockzilla, установка для пользователя (готовый бинарный файл, go install или go run), просмотр спецификации OpenAPI и запуск портативных серверов-моков локально. Никакие данные не покидают компьютер пользователя.

• Хостинговый уровень (с учетной записью): проксируется к MCP-эндпоинту mockzilla.org при установленной переменной MOCKZILLA_TOKEN. Позволяет просматривать симуляции, развертывать пакеты из каталога и т. д.

Без токена доступен только локальный уровень — агенты все равно могут помочь пользователям изучить mockzilla до регистрации.

Установка

Claude Code

Одной командой, без редактирования конфигурации:

claude mcp add -s user mockzilla -- npx -y @mockzilla/mcp@latest

-s user устанавливает его для вашей учетной записи пользователя (доступно в каждом проекте). Уберите -s user, чтобы ограничить область действия только текущим проектом.

Claude Desktop

Отредактируйте ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "mockzilla": {
      "command": "npx",
      "args": ["-y", "@mockzilla/mcp@latest"]
    }
  }
}

Cursor

Проще всего: Cursor Settings → MCP Servers → Add new MCP server, заполните:

• Name: mockzilla

• Command: npx

• Args: -y @mockzilla/mcp@latest

Или отредактируйте ~/.cursor/mcp.json напрямую:

{
  "mcpServers": {
    "mockzilla": {
      "command": "npx",
      "args": ["-y", "@mockzilla/mcp@latest"]
    }
  }
}

Gemini CLI

Одной командой, без редактирования конфигурации:

gemini mcp add -s user mockzilla npx -y @mockzilla/mcp@latest

-s user записывает в ~/.gemini/settings.json (доступно в каждом проекте). Уберите -s user (или используйте -s project), чтобы ограничить область действия файлом .gemini/settings.json в текущем каталоге.

Или отредактируйте файл настроек напрямую:

{
  "mcpServers": {
    "mockzilla": {
      "command": "npx",
      "args": ["-y", "@mockzilla/mcp@latest"]
    }
  }
}

После редактирования конфигурации перезапустите клиент.

Почему @latest? Без него npx кэширует первую разрешенную версию и не будет подхватывать новые публикации. Привязка к @latest заставляет npx повторно проверять реестр при каждом запуске, поэтому для обновления достаточно перезапустить Claude Desktop / Cursor. Минус: ~200 мс дополнительного времени на запуск.

Что можно спросить

Без токена (локальный уровень):

• "Is the mockzilla CLI installed?"

• "Install mockzilla for me." (агент спросит: download / go-install / go-run)

• "Spin up the petstore spec locally so I can curl it."

• "What endpoints does https://example.com/openapi.yaml have?"

• "Stop the mock you started."

С токеном (добавлен хостинговый уровень):

• "List the sims I have deployed."

• "Show me the catalog products."

• "Deploy a Stripe sandbox named stripe-test and wait for the live URL."

• "Create a mock from this OpenAPI URL on mockzilla."

Инструменты

Локальные

Хостинговые

Доступны, когда установлена переменная MOCKZILLA_TOKEN. Перенаправляются на mockzilla.org. См. документацию хостингового сервера для получения актуального списка инструментов — на момент написания он включает get_context, list_sims, list_catalog_products, deploy_mock_from_{catalog,spec,url} и wait_for_deploy.

Конфигурация

Кэш

Мост хранит все данные в ~/.cache/mockzilla-mcp/:

~/.cache/mockzilla-mcp/
├── bin/mockzilla        # downloaded or go-installed binary
├── config.json          # {method, version, invocation?}
└── mocks/               # mock_endpoint persists static endpoints here
    └── static/
        └── <service>/<path>/<method>/index.<ext>

rm -rf ~/.cache/mockzilla-mcp полностью сбрасывает мост (бинарный файл + все моки). Чтобы удалить только моки: rm -rf ~/.cache/mockzilla-mcp/mocks. Системный PATH никогда не затрагивается, поэтому сброс не влияет на отдельную установку через brew.

Обновления

Мост обновляется часто; рекомендуемый способ поддерживать актуальность:

1. Привяжите @mockzilla/mcp@latest в конфигурации вашего MCP-клиента (см. фрагменты установки выше), чтобы npx повторно проверял реестр при каждом запуске.

2. Периодически перезапускайте Claude Desktop / Cursor — именно в этот момент загружается новая версия.

3. Если что-то сломалось, спросите агента: "Run bridge_status and tell me if mockzilla-mcp is up to date." Если версия устарела, выполните npx clear-npx-cache @mockzilla/mcp и перезапустите клиент.

Версия CLI mockzilla привязана к мосту (MOCKZILLA_VERSION в lib/install.js). Обновление моста обновляет привязку; следующий вызов install_cli обновит сам CLI.

Разработка

См. CLAUDE.md для ознакомления с правилами проекта и пошаговым руководством по добавлению нового инструмента.

Лицензия

MIT.