agenthub-monitor

AgentHub Monitor

一个 MCP App 服务：它会在宿主窗口中（Claude Desktop、Claude Code 及其他支持 MCP App 的客户端）呈现交互式流水线仪表板，而不是返回一大段文本。

仪表板并排展示两项内容：

• DAG 状态——流水线运行中的节点，按波次分组，每个节点都有自己的状态。
• 测试框架指标——场景通过率、严重故障、累计成本和延迟。

将它指向你自己的流水线 JSON 导出文件，它就会实时显示你的运行情况。即使没有任何配置，它也会提供内置示例，因此安装后即可使用 UI。

工具

工具	功能	只读
show_agenthub_monitor	在宿主中内嵌呈现仪表板	是
get_status	以结构化 JSON 返回当前流水线状态	是
trigger_action	在服务自身状态中记录操作请求	否

trigger_action 不会执行任何操作。 它会在服务的内存状态中添加注释，以便仪表板显示已请求某项操作。此服务不会运行命令、启动进程或发起网络请求。

安装

需要 Python 3.10+。没有第三方依赖。

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

配置

添加到你的 MCP 客户端配置中：

{
  "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_sample_data: true，以免被误认为是真实运行数据。

状态文件格式

从你自己的 CI、编排器或测试框架写入此 JSON：

{
  "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."
}

每次调用工具时都会重新读取该文件，因此仪表板会反映流水线最近一次写入的内容。节点状态字符串会原样传递到 UI；COMPLETED、RUNNING、PENDING 和 FAILED 会显示为不同颜色。

资源

UI 以 MCP 资源的形式公开，地址为 ui://agenthub/mcp-app.html，MIME 类型为 text/html;profile=mcp-app。支持 MCP Apps 的宿主会将其内嵌呈现；不支持的宿主仍可将其作为 HTML 文档读取。

隐私

服务只会读取一个本地文件（即你在 AGENTHUB_STATE_FILE 中指定的文件），不会向任何地方发送数据。请参阅 PRIVACY.md。

许可证

MIT——请参阅 LICENSE。