MCP Agent Health Reporter

io.github.aos-standard由 GitHub 账号 aos-standard 发布v0.3.1更新于 Oct 24, 2026

Advisory AOS agent health scan before deployment (manifest, services, immune loop, evidence).

已验证STDIO仅桌面开发者工具安全与监控

概览

AI 生成的概览

扫描本地 AI 代理目录，返回 AOS 就绪评分、分项得分和审计摘要，用于部署前检查。

可以做什么
提供两个工具：aos_agent_health_scan 对目标目录中的单个代理评分，返回 aos_score、certified 标志、各分项得分（清单声明、systemd 运行时、免疫循环、物理证据）以及先例元数据；aos_agent_health_audit 扫描整个目录，返回 total_tools、avg_score 等汇总和每个代理的报告。它是建议性工具，用于发现本地正常但部署后失效的代理。
适用场景
当你维护一个代理定义目录，需要在部署前做就绪检查，或对多个代理做批量审计时使用。适合本地开发流程中希望得到评分报告而非人工检查的场景。
运行要求
以 PyPI 包 mcp-agent-health 通过 stdio 在本地运行，可用 uvx 启动或 pip 安装，需要 Python。可选环境变量：AOS_HEALTH_TARGET_DIR 设置默认扫描根目录（回退为当前工作目录），AOS_HEALTH_MCP_LOG 设置 JSONL 日志路径，AOS_HEALTH_MCP_TRANSPORT 选择传输方式（默认 stdio）。未声明账号或 API 密钥。
安装前请注意
扫描会读取你指定的目录，请谨慎选择目标路径。它会写入 JSONL 调用日志，默认位于用户主目录下的 ~/.aos_health_mcp/calls.jsonl，可用 AOS_HEALTH_MCP_LOG 重定向。评分仅供参考，certified 标志并非权威批准。README 说明该服务器已从 aos-agent-health-mcp 改名，现有 MCP 配置需要更新。

安装

在 SourceWeft 中

  1. 打开 控制台中的 MCP Agent Health Reporter，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

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

bash
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):

json
{  "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):

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

Response:

json
{  "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:

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

Response (excerpt):

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

Self-Test (G1 evidence)

bash
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（直接編集禁止 — 同期スクリプト経由）

bash
python3 packaging/scripts/sync_scan_pure.py          # copy + verifypython3 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)

bash
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)

来源：packaging/README.md，提交 cec614f

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.3.1最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分