MCP Agent Health Reporter

本地服务

raw.githubusercontent.com开发工具015 周前更新

代码仓库访问官网

关于 MCP Agent Health Reporter

MCP Agent Health Reporter 按照 AOS 规范扫描 Agent 并报告就绪评分，供团队在部署前检查 Agent 健康状况。它支持单个 Agent 扫描，也可审计整个目录。

主要功能

01扫描 Agent 并报告评分
02审计目录中的 Agent
03报告认证状态
04将调用记录为 JSONL 证据

适用场景

01部署前检查 Agent
02审计 Agent 目录
03查看就绪评分和认证状态

MCP 相关

它向 MCP 客户端提供 `aos_agent_health_scan` 和 `aos_agent_health_audit` 工具。服务默认使用 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.1stdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

MCP Agent 健康报告工具

已重命名（2026-07）： 原名为 aos-agent-health-mcp / CLI aos-health-mcp。请通过 pip install mcp-agent-health==0.3.1 迁移，并将 MCP 配置中的 command 更新为 mcp-agent-health。

可验证 Agent 在 AOS 规范下的健康状况并报告就绪度评分的 MCP 服务。用于发现那些在生产环境中悄无声息地失效的 Agent——本地运行正常，部署后却无法工作。

安装

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

MCP 客户端配置

在 mcp.json（Cursor / Claude Desktop）中添加：

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

工具：`aos_agent_health_scan`

请求（非默认参数——实际信号）：

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

响应：

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

工具：`aos_agent_health_audit`

请求：

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

响应（节选）：

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

自测（G1 证据）

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

正本同步（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 干净安装（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

环境变量

变量	说明
`AOS_HEALTH_TARGET_DIR`	默认扫描根目录（回退值：cwd）
`AOS_HEALTH_MCP_LOG`	JSONL 日志路径（默认：`~/.aos_health_mcp/calls.jsonl`）
`AOS_HEALTH_MCP_TRANSPORT`	`stdio`（默认）