mcp-zuul — MCP-сервер для Claude Code: анализ CI
Сервер помогает разбирать сбои Zuul CI, искать ошибки в логах и проверять состояние сборок. Пригодится, когда нужно выяснить, какая задача завершилась с ошибкой.
claude mcp add --env ZUUL_URL=<ZUUL_URL> --env ZUUL_DEFAULT_TENANT=<ZUUL_DEFAULT_TENANT> --env ZUUL_AUTH_TOKEN=<ZUUL_AUTH_TOKEN> --env ZUUL_USE_KERBEROS=<ZUUL_USE_KERBEROS> --env MCP_TRANSPORT=<MCP_TRANSPORT> --transport stdio mcp-zuul -- uvx mcp-zuulЧто делает mcp-zuul
mcp-zuul подключает Zuul CI к ИИ-клиенту через MCP. Он может разобрать данные о сбое сборки, найти строки в логах по регулярному выражению и показать прогресс конвейера. Есть инструменты для поиска нестабильных заданий и просмотра зависимостей между jobs; всего перечислено 48 инструментов, 5 промптов и 3 ресурса.
Для запуска в Claude Code используется uvx. Адрес Zuul задаётся через ZUUL_URL; также доступны настройки tenant, токена авторизации, Kerberos и транспорта. Сервер поддерживает stdio, SSE и streamable HTTP. Операции, которые меняют конвейер, отключены при ZUUL_READ_ONLY=true; для анализа аномалий в логах нужна настройка LOGJUICER_URL.
Без корректного ZUUL_URL серверу некуда обращаться. Если включить операции записи, они смогут ставить изменения в очередь, удалять их оттуда и продвигать по конвейеру.
Какие задачи решает
- найти задачу и хост, на которых упала сборка
- поискать ошибки в логах по регулярному выражению
- проверить прогресс задания в конвейере Zuul
- выявить нестабильные jobs по истории сборок
- посмотреть зависимости заданий для проекта и ветки
Примеры запросов агенту
- Разбери сбой сборки Zuul и покажи задачу, хост и текст ошибки.
- Найди в логах сборки строки с ошибками и покажи контекст вокруг них.
- Проверь текущий прогресс изменений в конвейере Zuul.
Как установить mcp-zuul
Командой платформы
claude mcp add --env ZUUL_URL=<ZUUL_URL> --env ZUUL_DEFAULT_TENANT=<ZUUL_DEFAULT_TENANT> --env ZUUL_AUTH_TOKEN=<ZUUL_AUTH_TOKEN> --env ZUUL_USE_KERBEROS=<ZUUL_USE_KERBEROS> --env MCP_TRANSPORT=<MCP_TRANSPORT> --transport stdio mcp-zuul -- uvx mcp-zuulВместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-zuul <команда>
Командой платформы
codex mcp add mcp-zuul --env ZUUL_URL=<ZUUL_URL> --env ZUUL_DEFAULT_TENANT=<ZUUL_DEFAULT_TENANT> --env ZUUL_AUTH_TOKEN=<ZUUL_AUTH_TOKEN> --env ZUUL_USE_KERBEROS=<ZUUL_USE_KERBEROS> --env MCP_TRANSPORT=<MCP_TRANSPORT> -- uvx mcp-zuulВместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-zuul <команда>
Файл настроек
{
"mcpServers": {
"mcp-zuul": {
"command": "uvx",
"args": [
"mcp-zuul"
],
"env": {
"ZUUL_URL": "<ZUUL_URL>",
"ZUUL_DEFAULT_TENANT": "<ZUUL_DEFAULT_TENANT>",
"ZUUL_AUTH_TOKEN": "<ZUUL_AUTH_TOKEN>",
"ZUUL_USE_KERBEROS": "<ZUUL_USE_KERBEROS>",
"MCP_TRANSPORT": "<MCP_TRANSPORT>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-zuul <команда>
Файл настроек
{
"servers": {
"mcp-zuul": {
"type": "stdio",
"command": "uvx",
"args": [
"mcp-zuul"
],
"env": {
"ZUUL_URL": "<ZUUL_URL>",
"ZUUL_DEFAULT_TENANT": "<ZUUL_DEFAULT_TENANT>",
"ZUUL_AUTH_TOKEN": "<ZUUL_AUTH_TOKEN>",
"ZUUL_USE_KERBEROS": "<ZUUL_USE_KERBEROS>",
"MCP_TRANSPORT": "<MCP_TRANSPORT>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-zuul <команда>
Командой платформы
gemini mcp add -e ZUUL_URL=<ZUUL_URL> -e ZUUL_DEFAULT_TENANT=<ZUUL_DEFAULT_TENANT> -e ZUUL_AUTH_TOKEN=<ZUUL_AUTH_TOKEN> -e ZUUL_USE_KERBEROS=<ZUUL_USE_KERBEROS> -e MCP_TRANSPORT=<MCP_TRANSPORT> mcp-zuul uvx mcp-zuulВместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-zuul <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-zuul
Как установить mcp-zuul в Claude Code?
Выполните claude mcp add mcp-zuul -- uvx mcp-zuul. Для подключения к своему серверу Zuul настройте ZUUL_URL.
Что делает mcp-zuul?
Он подключает инструменты Zuul CI к MCP-клиенту: помогает анализировать сбои, искать по логам и получать статус конвейера.
Нужен ли токен авторизации для работы?
Среди настроек есть ZUUL_AUTH_TOKEN и ZUUL_USE_KERBEROS. Для некоторых серверов поддерживается аутентификация Kerberos/SPNEGO.
