# Advanced Zebrunner MCP Server

MCP-сервер для Zebrunner: отчёты, разбор падений тестов и безопасные правки тест-кейсов прямо из агента.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5
- Автор: maksimsarychau
- Лицензия: AGPL-3.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/maksimsarychau/mcp-zebrunner
- Обновлён: 2026-09-16
- HTML: https://affpapa.org/nevibecode/mcp/advanced-zebrunner-mcp-server

## Что делает

Сервер даёт агенту доступ к Zebrunner через Public API: 76 инструментов с префиксом `adv_`, ресурсы для подстановки контекста через `@` и промпты-команды через `/`. Инструменты названы `adv_<name>`, например `adv_create_test_case` и `adv_list_test_runs`, поэтому они не конфликтуют с официальным Zebrunner MCP. Старые имена пока работают как deprecated-алиасы, но их уберут в следующем мажорном релизе — если ваши скрипты и промпты вызывают старые имена, это повод переписать их заранее.

Что внутри: аналитика прогонов и pass-rate, отчёты о стабильности регрессии, поиск пробелов в покрытии, оценка готовности к автоматизации, правила проверки тест-кейсов, анализ скриншотов и видео через sharp, ffmpeg и tesseract, управление запусками и тест-ранами. Есть мастер `adv_scaffold_test_case` для написания тест-кейсов и `adv_prepare_jira_automation_plan`, который превращает сьют Zebrunner в план для Jira. Поддерживаются STDIO, Streamable HTTP, OAuth, Okta SSO и token exchange.

Для запуска нужны три переменные: `ZEBRUNNER_URL`, `ZEBRUNNER_LOGIN` и `ZEBRUNNER_TOKEN`. Опционально задаются `TIMEOUT` и `RETRY_ATTEMPTS`. В конфиге `zebrunner-config.json` можно прописать `projectAliases`, чтобы инструменты принимали короткие имена проектов наравне с ключами Zebrunner.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `ZEBRUNNER_URL`, `ZEBRUNNER_LOGIN`, `ZEBRUNNER_TOKEN`, `TIMEOUT`, `RETRY_ATTEMPTS`, `RETRY_DELAY`, `MAX_PAGE_SIZE`, `DEFAULT_PAGE_SIZE`, `DEBUG`, `ENABLE_RULES_ENGINE` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

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

**Командой платформы**
```bash
claude mcp add --env ZEBRUNNER_URL=<ZEBRUNNER_URL> --env ZEBRUNNER_LOGIN=<ZEBRUNNER_LOGIN> --env ZEBRUNNER_TOKEN=<ZEBRUNNER_TOKEN> --env TIMEOUT=<TIMEOUT> --env RETRY_ATTEMPTS=<RETRY_ATTEMPTS> --transport stdio advanced-zebrunner-mcp-server -- npx -y mcp-zebrunner
```
Вместо <…> подставьте свои значения. Ещё 14 переменных окружения — в README сервера

### Codex

**Командой платформы**
```bash
codex mcp add advanced-zebrunner-mcp-server --env ZEBRUNNER_URL=<ZEBRUNNER_URL> --env ZEBRUNNER_LOGIN=<ZEBRUNNER_LOGIN> --env ZEBRUNNER_TOKEN=<ZEBRUNNER_TOKEN> --env TIMEOUT=<TIMEOUT> --env RETRY_ATTEMPTS=<RETRY_ATTEMPTS> -- npx -y mcp-zebrunner
```
Вместо <…> подставьте свои значения. Ещё 14 переменных окружения — в README сервера

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "advanced-zebrunner-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "mcp-zebrunner"
            ],
            "env": {
                "ZEBRUNNER_URL": "<ZEBRUNNER_URL>",
                "ZEBRUNNER_LOGIN": "<ZEBRUNNER_LOGIN>",
                "ZEBRUNNER_TOKEN": "<ZEBRUNNER_TOKEN>",
                "TIMEOUT": "<TIMEOUT>",
                "RETRY_ATTEMPTS": "<RETRY_ATTEMPTS>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. Ещё 14 переменных окружения — в README сервера

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "advanced-zebrunner-mcp-server": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "mcp-zebrunner"
            ],
            "env": {
                "ZEBRUNNER_URL": "<ZEBRUNNER_URL>",
                "ZEBRUNNER_LOGIN": "<ZEBRUNNER_LOGIN>",
                "ZEBRUNNER_TOKEN": "<ZEBRUNNER_TOKEN>",
                "TIMEOUT": "<TIMEOUT>",
                "RETRY_ATTEMPTS": "<RETRY_ATTEMPTS>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. Ещё 14 переменных окружения — в README сервера

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e ZEBRUNNER_URL=<ZEBRUNNER_URL> -e ZEBRUNNER_LOGIN=<ZEBRUNNER_LOGIN> -e ZEBRUNNER_TOKEN=<ZEBRUNNER_TOKEN> -e TIMEOUT=<TIMEOUT> -e RETRY_ATTEMPTS=<RETRY_ATTEMPTS> advanced-zebrunner-mcp-server npx -y mcp-zebrunner
```
Вместо <…> подставьте свои значения. Ещё 14 переменных окружения — в README сервера

## Когда брать
- собрать отчёт о стабильности регрессии за период
- найти пробелы в покрытии между сьютами
- оценить готовность тест-кейсов к автоматизации
- разобрать падение теста по скриншоту или видео
- перезапустить упавшие тесты в запуске

## Примеры запросов агенту
- Покажи pass-rate по проекту за последнюю неделю и отметь просевшие сьюты
- Найди пробелы в покрытии между сьютами и предложи, что дописать
- Разбери скриншот упавшего теста и скажи, что пошло не так

## Похожие
- [Front-End Checklist](https://affpapa.org/nevibecode/mcp/front-end-checklist.md) — MCP-сервер · ★ 74569
- [Keploy](https://affpapa.org/nevibecode/mcp/keploy.md) — MCP-сервер · ★ 18779
- [SeleniumBase MCP](https://affpapa.org/nevibecode/mcp/seleniumbase-mcp.md) — MCP-сервер · ★ 13181
- [mobile-mcp](https://affpapa.org/nevibecode/mcp/mobile-mcp.md) — MCP-сервер · ★ 10025
- [e2e](https://affpapa.org/nevibecode/mcp/e2e.md) — MCP-сервер · ★ 11962

_Часть страницы не вошла по размеру — она есть в HTML-версии._

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