agenthub-monitor

AgentHub Monitor

MCP アプリサーバーです。テキストを大量に返す代わりに、ホストウィンドウ内（Claude Desktop、Claude Code、およびその他のMCP アプリ対応クライアント）にインタラクティブなパイプラインダッシュボードを表示します。

ダッシュボードには、次の2つの情報が並べて表示されます。

• 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 は、MIME タイプtext/html;profile=mcp-appのMCP リソースui://agenthub/mcp-app.htmlとして公開されています。MCP アプリに対応するホストではインライン表示され、対応していないホストでも HTML ドキュメントとして読み取れます。

プライバシー

サーバーが読み取るのはローカルファイル1つ（AGENTHUB_STATE_FILEで指定したファイル）のみで、データを外部に送信することはありません。PRIVACY.mdをご覧ください。

ライセンス

MIT — LICENSEをご覧ください。