agent-evidence-mcp

[](https://github.com/xiexie-qiuligao/agent-evidence-mcp/releases) [](https://github.com/xiexie-qiuligao/agent-evidence-mcp/actions/workflows/ci.yml) [](./LICENSE)

让 agent 在执行长任务时，自动留下截图、录屏、备注和总结。

Agent Evidence MCP 不是单纯的截图工具，它更适合这些场景：

• 让 agent 操作浏览器后台、桌面软件或多步骤流程
• 希望每到关键节点自动留图，出错时额外留证据
• 做完后需要一个清晰的交付目录，方便自己、同事或客户复盘

• 开一个任务会话：start_session
• 在关键节点截图：capture_checkpoint
• 必要时录一小段屏幕：start_recording / stop_recording
• 给证据加备注或 OCR 文本：attach_note / ocr_artifact
• 对敏感区域打码，生成可分享副本：redact_artifact
• 结束时自动拿到 summary.md、timeline.jsonl 和所有 artifact

它最适合配合 agent 一起用。你不用自己手动调很多命令，通常只要告诉 agent：

用 agent-evidence MCP 帮我完成这个任务。
开始前先创建一个 session。
每到关键节点截一张图，出错时额外截图。
优先截图，只有在动作过程很重要时才短录屏。
结束后把 summary 和所有关键产物路径告诉我。

1. 安装

pip install -e .

1. 初始化配置

agent-evidence-mcp init

1. 启动 MCP 服务

agent-evidence-mcp serve

创建一个 session：

agent-evidence-mcp start-session "Admin QA Flow"

截一张关键节点图：

agent-evidence-mcp capture-checkpoint "D:\path\to\session" "form-submitted" "The form was submitted successfully."

结束并生成总结：

agent-evidence-mcp end-session "D:\path\to\session"

artifacts/
  <session_id>/
    session.json
    timeline.jsonl
    summary.md
    details/
    screenshots/
    recordings/

你最终拿到的不是一堆散乱截图，而是一整套有时间线、有总结、可复盘的任务证据。

| 能力 | Windows | macOS | Linux | | --- | --- | --- | --- | | Session / MCP / CLI | 已实现 | 已实现 | 已实现 | | 截图 | 已实现并已本地验证 | 已实现 | 已实现 | | 录屏 | 已实现并已本地验证 | 已实现 | 已实现 | | Redaction | 已实现并已本地验证 | 未实现 | 未实