mcpField
M
MCP Agent Health Reporter

MCP Agent Health Reporter

ローカル
raw.githubusercontent.com開発ツール015 週間前に更新
リポジトリ公式サイト

MCP Agent Health Reporter について

MCP Agent Health Reporterは、AOSの規律に沿ってエージェントをスキャンし、準備状況のスコアを報告します。デプロイ前の健全性確認を行うチーム向けで、個別スキャンとディレクトリ全体の監査に対応します。

主な機能

  1. 01エージェントのスキャンとスコア報告
  2. 02ディレクトリ内エージェントの監査
  3. 03認定状況の報告
  4. 04呼び出しをJSONL証跡として記録

活用シーン

  1. 01デプロイ前のエージェント確認
  2. 02エージェントディレクトリの監査
  3. 03準備状況スコアと認定状況の確認

MCP 対応

`aos_agent_health_scan`と`aos_agent_health_audit`ツールをMCPクライアントに公開します。サーバーはデフォルトでstdioを使用します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "aos-standard-mcp-agent-health": {
      "command": "uvx",
      "args": [
        "mcp-agent-health"
      ]
    }
  }
}
起動コマンドuvx mcp-agent-health

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
pypimcp-agent-health0.3.1

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

README（原文）English

プロジェクトの README より

この README の日本語訳はまだありません。以下は英語の原文です。日本語の紹介はページ上部をご覧ください。

MCP Agent Health Reporter

Renamed (2026-07): Formerly aos-agent-health-mcp / CLI aos-health-mcp. Migrate with pip install mcp-agent-health==0.3.1 and update your MCP config command to mcp-agent-health.

MCP server that validates agent health under AOS discipline and reports readiness scores. Use it to catch agents that silently fail in production — healthy locally, broken when deployed.

Install

pip install mcp-agent-health==0.3.1
# or editable from source:
# pip install -e ./packaging

MCP Client Configuration

Add to your mcp.json (Cursor / Claude Desktop):

{
  "mcpServers": {
    "mcp-agent-health": {
      "command": "mcp-agent-health",
      "args": [],
      "env": {
        "AOS_HEALTH_TARGET_DIR": "/path/to/your/agents"
      }
    }
  }
}

Tool: aos_agent_health_scan

Request (non-default args — real signal):

{
  "tool_id": "1066",
  "target_dir": "/home/builder/my-agents",
  "mock": false
}

Response:

{
  "status": "success",
  "aos_score": 62.5,
  "certified": false,
  "tool_id": "1066",
  "target_dir": "/home/builder/my-agents",
  "target_path": "/home/builder/my-agents/1066_AOS_Agent_Health_Reporter",
  "sections": {
    "manifest_declared": 12.5,
    "systemd_runtime": 0.0,
    "immune_loop": 0.0,
    "physical_evidence": 25.0
  },
  "precedent_meta": {
    "precedent_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "tool_id": "1066",
    "created_date": "2026-06-14T12:00:00+00:00",
    "source_signal_hash": "a1b2c3d4"
  },
  "scanned_at": "2026-06-14T12:00:00+00:00"
}

Tool: aos_agent_health_audit

Request:

{
  "target_dir": "/home/builder/my-agents",
  "mock": false
}

Response (excerpt):

{
  "status": "success",
  "total_tools": 3,
  "avg_score": 54.2,
  "target_dir": "/home/builder/my-agents",
  "reports": []
}

Self-Test (G1 evidence)

python3 packaging/scripts/smoke_self_call.py
# Appends one line to ~/.aos_health_mcp/calls.jsonl

Canonical source sync (TASK B)

正本: core/ahr_scan_pure.py（直接編集はこちらのみ）
配布コピー: packaging/aos_health_mcp/_scan_pure.py（直接編集禁止 — 同期スクリプト経由）

python3 packaging/scripts/sync_scan_pure.py          # copy + verify
python3 packaging/scripts/sync_scan_pure.py --check-only  # CI gate

一致検証: pytest tests/test_logic.py::TestAosAgentHealthReporter::test_scan_pure_canonical_sync

G2 clean install (mock=false)

python3 -m venv /tmp/aos-g2-venv
/tmp/aos-g2-venv/bin/pip install -e packaging/
/tmp/aos-g2-venv/bin/python packaging/scripts/g2_clean_install_smoke.py

Environment Variables

VariableDescription
AOS_HEALTH_TARGET_DIRDefault scan root (fallback: cwd)
AOS_HEALTH_MCP_LOGJSONL log path (default: ~/.aos_health_mcp/calls.jsonl)
AOS_HEALTH_MCP_TRANSPORTstdio (default)

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。