imatza-rh/mcp-zuul

What's New

Major feature release — 23 tools (was 14), 3 prompts, 3 resources.

New Tools (9)

• get_config_errors — why jobs aren't running: broken configs, missing refs, repo access issues
• list_projects — discover all projects in a tenant with optional name filter
• list_nodes — nodepool nodes with state summary (ready/in-use/building)
• list_labels — available node types that jobs can request
• list_semaphores — resource locks with holder count and capacity
• list_autoholds — nodes held after failure for debugging
• get_freeze_jobs — resolved job dependency graph for a pipeline/project/branch
• find_flaky_jobs — analyze build history to detect intermittent failures
• tail_build_log — last N lines of a log, most token-efficient way to check failures

Prompts (3, new)

• debug_build — pre-loads build details + structured failures in one action
• compare_builds — two builds side-by-side for differential analysis
• check_change — live pipeline status or latest results for a change

Resources (3, new)

• zuul://{tenant}/build/{uuid} — build details as attachable context
• zuul://{tenant}/job/{name} — job configuration with variants
• zuul://{tenant}/project/{name} — project pipeline/job mappings

Other Improvements

• URL-based input — 7 tools accept Zuul URLs directly, auto-parsing tenant + UUID
• Streamable HTTP transport — MCP_TRANSPORT=streamable-http for remote deployment
• Tool filtering — ZUUL_ENABLED_TOOLS / ZUUL_DISABLED_TOOLS to reduce LLM noise
• ToolAnnotations — readOnlyHint=True on all tools per MCP spec
• Kerberos auth tests — previously untested auth.py now covered
• 169 tests (was 97, +74%)

Install / Upgrade

uvx mcp-zuul                    # run directly
pip install --upgrade mcp-zuul   # or install