SuperAPI AI 工具集
合作ENAI 行业资讯收藏
全部工具AI智能体Agent-Memory-Bridge

Agent-Memory-Bridge

Agent-Memory-Bridge（AMB）是一个面向编码代理的本地优先记忆层，通过 MCP 协议为编码会话提供持久化的工程记忆。它让代理能够跨会话、跨工具记住项目决策及其原因，而不是在每次新会话中从头开始。AMB 将“代码能说明项目是什么（WHAT）”与“对话能说明项目为何如此（WHY）”作为信任边界区分：仓库事实来自干净的 Git 提交，可重新构建；而持久项目知识则是显式、可审查、受治理的。记忆来源、时效性与变更历史均可追溯。AMB 要求 Python 3.11+、Git 以及支持 stdio 或 Streamable HTTP 的 MCP 兼容编码客户端。当前版本 0.36.0，采用 MIT 许可证。它不会自动学习，也不会静默归档所有对话或将每条记忆视为同等权威，公开 MCP 工具表面固定为 17 个。

访问官网

工具介绍

用途

Agent-Memory-Bridge（AMB）是一个面向编码代理的工程记忆系统，通过 MCP（Model Context Protocol）协议提供持久化的项目记忆。它旨在解决一个问题：项目不仅仅是当前的文件集合，随着时间推移，有用的上下文会散落在仓库、聊天、编码代理、评审、修复和一次性决策中；新的会话能看到代码，却可能缺失让项目合理运作的原因。AMB 为这些决策提供一个持久存在的位置，让编码代理能够跨会话、跨工具、跨时间记住真正重要的决策。

主要能力

  • 持久化工程记忆：通过 MCP 提供本地 stdio 服务器，连接兼容的编码客户端，让代理可以存储和回忆项目决策及其原因。
  • 项目初始化与解析：Project Init 会检测本地 Git 仓库，建议命名空间（如 project:my-app），等待确认后派生当前仓库基线；project resolve . 可在已绑定后解析命名空间，无需重新初始化。
  • 显式记忆与信任边界：AMB 不会从代码推断决策，也不会归档对话记录。记忆必须通过公开的 store 工具显式教授。
  • WHAT/WHY 分离：仓库事实（WHAT）来自干净的 Git 提交，可重新构建；持久项目知识（WHY）保持显式、可审查、受治理。
  • 本地可检查：Explore 回答“AMB 当前对该项目了解什么？”，Inspect 回答“为什么这条信息会针对这个问题浮现？”，两者均为本地只读。
  • 治理模型：支持 forget、feedback、promote、annotate、revise、export 等操作，以及 run 记录和信号租约机制，帮助维护记忆的可信度。
  • 公开 MCP 工具：固定 17 个公开 MCP 工具，包括 store、recall、browse、stats、forget、feedback、promote、annotate、revise、export、begin_run、record_run_event、get_run、complete_run、claim_signal、extend_signal_lease、ack_signal。

使用方式

  1. 安装要求：需要 Python 3.11+、Git，以及能够启动本地 stdio 服务器或通过 Streamable HTTP 连接的 MCP 兼容编码客户端。
  2. 推荐设置：可安装官方配套技能 Agent-Memory-Skills 中的 amb（日常记忆回忆、存储、修订、注释）和 amb-connect（宿主能力发现、stdio/Streamable HTTP MCP、工具配置），例如在支持技能的代理 CLI 中运行 npx skills add zzhang82/Agent-Memory-Skills --skill amb 或 --skill amb-connect。技能说明可直接阅读 SKILL.md。
  3. 手动快速开始：使用虚拟环境（.amb-venv）以获得稳定的 Python 启动器，将 <venv-python> 替换为对应操作系统的 Python 可执行文件。
  4. 初始化或解析项目：Project Init 检测 Git 仓库、建议命名空间并等待确认，然后派生当前仓库基线；绑定后可用 project resolve . 解析命名空间。
  5. 运行通用 MCP 服务器：将 AMB 作为标准 MCP stdio 服务器运行，命令为 <venv-python>，参数为 -m agent_mem_bridge，并设置一个持久的 AGENT_MEMORY_BRIDGE_HOME 供所有访问该项目记忆的客户端共享。
  6. 使用或检查记忆：通过连接的客户端，使用 store 工具显式教授项目决策，例如“记住我们在目标分支 CI 通过后才合并拉取请求，因为本月 main 分支被破坏阻塞了两次发布”。代理会将显式决策和原因存储在项目命名空间下。在新会话中询问“合并拉取请求前需要满足什么？”，新会话会回答存储的决策和原因。
  7. 查看记忆：用 Explore 查看 AMB 当前对该项目的了解，用 Inspect 查看信息浮现的原因；两者均为本地只读。刷新仓库事实需显式重新运行原语，刷新不会改变持久的项目 WHY。

适用场景

适用于使用编码代理进行跨会话开发的项目，尤其是需要保留架构决策、易错点（gotchas）和领域知识，避免每次新会话重复解释项目背景的场景。也适合希望记忆系统本地优先、可审查、来源可追溯的团队。

限制

  • AMB 不会自动学习，不会从代码推断决策，也不会将对话记录自动转化为持久事实。
  • 客户端连接不在 AMB Core 范围内；AMB 不发现、写入或认证 Codex、Claude、Cursor、OpenCode、Hermes、Cline、VS Code 或 Antigravity。客户端需独立配置 AMB 为标准 MCP stdio 服务器，指向相同的本地 AMB home 以共享项目记忆。
  • 如果现有 bridge 位于 ~/.codex/mem-bridge，v0.36 不会自动打开它，需设置 AGENT_MEMORY_BRIDGE_HOME 指向该目录，或将其复制到 ~/.local/share/agent-memory-bridge。
  • 当前版本 0.36.0，Schema 为 v12，公开 MCP 工具表面恰为 17 个，没有第 18 个 MCP 工具，也没有自动学习。
  • 健康检查（如 doctor 和 verify）测试服务器前置条件，不证明编码客户端已加载 MCP 配置。
  • 本地协议缓存契约为发现 300000/public，工具列表 0/private；详见 MCP Compatibility。
  • 许可为 MIT。开发与公开表面期望见 CONTRIBUTING.md，漏洞报告见 SECURITY.md。
  • 部分配置细节、具体安装命令和生命周期钩子输入见 Integrations；本文未提供的内容暂未提供。

同类工具

查看分类