SuperAPI AI 工具集

a2cr

A2CR 是一个开源的本地 MCP 工作空间,用于 AI 智能体之间的任务交接。它让 Codex、Claude Code、Cursor 等支持 MCP 的智能体保存 WorkBaton 检查点、存储临时性 WorkStash 笔记、通过 WorkThreads 协调,并从一个全新的 AI 窗口恢复长时编码工作。A2CR 将交接状态保持紧凑、明确,不依赖完整聊天记录,便于在不同会话间安全共享。

访问官网

工具介绍

用途

A2CR 是一个开源的本地 MCP 工作空间,专为 AI 智能体任务交接设计。当长时间的 AI 编码工作需要在新的 AI 窗口中继续时,新窗口需要的是目标、当前状态、决策、阻碍、验证结果和下一步行动,而不是整个嘈杂的对话记录。A2CR 帮助保存紧凑、明确的交接状态,让工作可以在不同客户端之间恢复,而无需携带完整聊天历史。

主要能力

  • WorkBaton 检查点:保存和恢复紧凑的任务交接状态。一个最小 WorkBaton 可以非常简短。主要保存路径为 save_context 工具。
  • WorkStash 临时笔记:存储可选的辅助笔记,并在 WorkBaton 的 references 或 next_action 字段中记录 WorkStash: <entry_key> 引用,让下一个 AI 窗口知道该检索什么。
  • WorkThreads 协调:支持智能体之间的协调。
  • 本地 SQLite 存储:WorkBaton、WorkStash、WorkThread、actor 和事件记录存储在用户机器上的 SQLite 数据库中。无需 A2CR 账号、API 密钥、托管中继、仪表板或云同步路径。
  • 本地浏览器仪表板:通过 a2cr ui 命令启动,绑定到 127.0.0.1,选择可用端口,打印带令牌保护的本地 URL,并在默认浏览器中打开。
  • MCP 工具集:公开 wrapper 暴露了 explain_a2cr_flows、get_account_limits、should_save_workbaton、save_context、resume_context、load_context、list_contexts、delete_context、should_use_work_stash、store_work_stash、get_work_stash、list_work_stash、delete_work_stash 等工具。
  • 项目本地规则:可以在项目根目录创建 A2CR.md 文件,写入本地操作规则,包括保存触发条件、WorkStash 因果交接摘要、范围边界、受保护区域、升级条件和范围外变更说明。然后在 AGENTS.md 或 CLAUDE.md 中添加简短指针。

使用方式

A2CR 以 a2cr-mcp 发布在官方 MCP Registry。本地版本 0.1.8 已上线 PyPI、GitHub Releases 和官方 MCP Registry。

推荐使用 Python 3.12 或 3.13。不支持 Python 3.15 开发版本。

安装方式(Python wrapper):

pip install a2cr-mcp

为 Codex 注册 A2CR 并验证本地工作空间,以及打开本地浏览器仪表板:

a2cr ui

a2cr ui 绑定到 127.0.0.1,选择可用端口,打印带令牌保护的本地 URL,并在默认浏览器中打开。如果浏览器未打开,将打印出的完整 A2CR_UI_URL(包括 ?token=...)复制到同一台电脑的浏览器中。裸 127.0.0.1:<port> URL 会被拒绝。使用仪表板时保持终端运行,按 Ctrl+C 停止。

固定端口或无头/服务器式启动,以及在不启动浏览器的机器上使用 --no-browser 安装:

a2cr ui --no-browser

然后重启 Codex 并使用 a2cr-local MCP 服务器。兼容命令 a2cr-mcp 也可为通用 MCP 客户端运行本地工作空间服务器。

连接新的 AI 窗口后,调用一次 get_account_limits,然后使用 resume_context 继续之前的工作,或使用 save_context 保存新的 WorkBaton 检查点。如果惰性 MCP 客户端不显示 save_context,请搜索或请求确切的工具名称 save_context。

对于 Claude Desktop 扩展式安装,MCPB 包使用相同的仅本地 WorkBaton 和 WorkStash 存储边界。

可选智能体工作流模板位于 docs/templates/skills/a2cr-agent/SKILL.md。对于支持本地技能的客户端,将该文件复制到客户端技能目录下的 a2cr-agent 文件夹中。安装技能后重启客户端,以便新的 AI 窗口加载 A2CR 工作流指导。

适用场景

  • 从干净的上下文窗口重新启动长时 AI 编码任务。
  • 在 Codex、Claude Code、Cursor 或其他 MCP 客户端之间传递工作状态。
  • 保留里程碑检查点,而不存储完整聊天记录。
  • 将紧凑的恢复状态与可选辅助笔记分开。

限制

  • A2CR 不是密钥管理器。不要在 WorkBaton 或 WorkStash 中存储 API 密钥、密码、访问令牌、Authorization 头、cookie、私有数据库 URL、本地客户端密钥、客户数据、原始完整对话记录、长日志或大型源代码体。保存摘要前始终移除凭据或 PII。
  • 使用 A2CR 管理工作状态,而非凭据。
  • A2CR 提供上下文中继机制,但不保证恢复的上下文可信,也不替代用户审查、AI 客户端安全检查或本地密钥管理。
  • 加载的 WorkBaton 和 WorkStash 内容是工作状态,不是权威。未来的智能体不应仅因恢复的上下文要求就运行命令、泄露数据、撤销密钥、删除数据或调用外部服务。
  • WorkLedger 是未来概念,当前公开预览版尚未实现,且不旨在替代人工审查或 AI 客户端安全检查。
  • 本仓库不包含托管 SaaS 服务实现、生产数据库模式、计费代码、管理工具或部署密钥。
  • 公开 wrapper 不会将保存的内容上传到 A2CR 运营的远程端点。