io.github.NEVELSK65/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.git
cd mcp-agenthub-monitor
python3 -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.