Agenthub Monitor

AgentHub Monitor

An MCP App server: it renders an interactive pipeline dashboard inside the host window (Claude Desktop, Claude Code, and other MCP App–capable clients) instead of returning a wall of text.

The dashboard shows two things side by side:

• DAG state — nodes of a pipeline run, grouped into waves, each with its own status.
• Harness metrics — scenario pass rate, critical failures, accumulated cost and latency.

Point it at your own pipeline's JSON export and it becomes a live view of your runs. With no configuration it serves a built-in sample, so the UI is useful the moment you install it.

Tools

trigger_action does not execute anything. It annotates the server's in-memory state so the dashboard can show that an action was requested. This server runs no commands, spawns no processes, and makes no network calls.

Install

Requires Python 3.10+. No third-party dependencies.

git clone https://github.com/NEVELSK65/mcp-agenthub-monitor.gitcd mcp-agenthub-monitorpython3 -m unittest discover -s tests    # optional: verify

Configure

Add to your MCP client configuration:

{  "mcpServers": {    "agenthub-monitor": {      "command": "python3",      "args": ["/absolute/path/to/mcp-agenthub-monitor/server.py"],      "env": {        "AGENTHUB_STATE_FILE": "/absolute/path/to/your/pipeline-state.json"      }    }  }}

AGENTHUB_STATE_FILE is optional. Without it the server returns sample data, flagged with is_sample_data: true so it is never mistaken for a real run.

State file format

Write this JSON from your own CI, orchestrator, or test harness:

{  "dag": {    "title": "Nightly build",    "total_nodes": 6,    "completed_nodes": 4,    "waves": 3,    "node_states": {      "node_01_checkout": "COMPLETED",      "node_02_unit_tests": "COMPLETED",      "node_03_integration": "RUNNING",      "node_04_security_scan": "PENDING"    }  },  "harness": {    "pass_rate_pct": 93.75,    "total_scenarios": 16,    "passed_scenarios": 15,    "critical_failures": 0,    "total_cost_usd": 0.112,    "total_latency_ms": 41700  },  "log": "Integration stage in progress."}

The file is re-read on every tool call, so the dashboard reflects whatever your pipeline last wrote. Node status strings are passed through to the UI as-is; COMPLETED, RUNNING, PENDING and FAILED get distinct colours.

Resource

The UI is exposed as an MCP resource at ui://agenthub/mcp-app.html with MIME type text/html;profile=mcp-app. Hosts that support MCP Apps render it inline; hosts that do not can still read it as an HTML document.

Privacy

The server reads one local file (the one you name in AGENTHUB_STATE_FILE) and sends nothing anywhere. See PRIVACY.md.

License

MIT — see LICENSE.