agent-audit-mcp

AgentAudit MCP

现在，你的 Agent 拥有一份不可变、防篡改的操作日志，记录其执行的每一项操作——每个事件都通过加密方式与前一个事件关联，因此任何修改都会破坏链条，并立即被检测到。

你的 Agent 可以做什么

• 使用包含前一个事件哈希值的 SHA-256 哈希记录 16 种事件类型中的任意一种（付款、任务、争议、身份检查、消息）
• 按 ID 检索任意 Agent 的完整历史记录——按顺序列出每项操作及其时间戳
• 按 Agent、事件类型、严重级别或日期范围搜索审计轨迹
• 验证任意两个事件之间的链条完整性，并获取逐事件的通过／失败明细，准确显示哪个链接遭到篡改
• 跟踪五个严重级别——info、notice、warning、error、critical——用于合规事件分级处理
• 获取整个审计轨迹的统计数据：按类型、按严重级别统计事件，以及最活跃的 Agent

安装

要求： Python 3.10+、mcp 和 fastmcp 软件包。

pip install mcp fastmcp

Claude Desktop — 添加到 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "agent-audit": {
      "command": "python",
      "args": ["/absolute/path/to/agent-audit-mcp/server.py"]
    }
  }
}

Cursor — 添加到项目根目录下的 .cursor/mcp.json：

{
  "mcpServers": {
    "agent-audit": {
      "command": "python",
      "args": ["/absolute/path/to/agent-audit-mcp/server.py"]
    }
  }
}

数据存储在本地的 ~/.agentaudit/chain.json 中。数据不会离开你的设备。

工具参考

工具	描述	关键参数
audit_log	记录事件并将其追加到哈希链	event_type（16 种之一）、agent_id、severity、details_json
audit_get_event	按 ID 检索完整事件详情	event_id
audit_search	按 Agent、类型、严重级别或日期范围筛选事件	agent_id、event_type、severity、from_date、to_date、max_results
audit_get_agent_history	某个 Agent 的所有事件，按时间从新到旧排列	agent_id、max_events
audit_verify_chain	检查两个事件之间的 SHA-256 链完整性；返回逐事件的 PASS／FAIL	from_event_id、to_event_id
audit_stats	摘要：事件总数、按类型／严重级别分类的统计、排名前 5 的活跃 Agent	—

支持的事件类型： task_created、task_assigned、task_completed、task_failed、payment_sent、payment_received、payment_refunded、dispute_raised、dispute_resolved、identity_verified、capability_used、agent_registered、agent_rated、agent_offline、message_sent、message_received

安全性

审计数据采用原子方式写入（先写入临时文件，再执行 os.replace），以防部分写入导致链条损坏。哈希涵盖每个字段，包括前一个事件的哈希值——你无法插入、删除或修改任何事件而不破坏所有后续哈希。audit_verify_chain 会从头重新计算每个哈希，而不是信任存储的值。

所有数据都存储在本地。此服务不会发出网络请求。

定价

方案	价格	包含内容
Pro	$19/月	无限量审计事件、完整链验证

通过 Stripe 订阅

许可证

专有软件——请参阅订阅条款。源代码：github.com/Rumblingb/agent-audit-mcp