MCP Memory 集成

# MCP Memory 集成

> 使用模型上下文协议（MCP）为任何代理提供跨会话的持久记忆。

## 功能说明

默认情况下，The Agency 中的代理每次会话都从零开始。上下文通过代理和会话之间的复制粘贴手动传递。MCP 内存服务器改变了这一点：

- **跨会话记忆**：代理记住以前会话中的决策、交付成果和上下文
- **交接连续性**：当一个代理交接给另一个代理时，接收代理可以准确回忆完成了什么——无需复制粘贴
- **失败时回滚**：当 QA 检查失败或架构决策证明错误时，回滚到已知良好状态而不是重新开始

## 设置

你需要一个提供内存工具的 MCP 服务器：`remember`、`recall`、`rollback` 和 `search`。将其添加到你的 MCP 客户端配置（Claude Code、Cursor 等）：

```json
{
  "mcpServers": {
    "memory": {
      "command": "your-mcp-memory-server",
      "args": []
    }
  }
}
```

任何公开 `remember`、`recall`、`rollback` 和 `search` 工具的 MCP 服务器都可以使用。查看 [MCP 生态系统](https://modelcontextprotocol.io) 获取可用实现。

## 如何为任何代理添加记忆

要通过持久记忆增强现有代理，请在代理提示词中添加**记忆集成**部分。此部分指示代理在关键时刻使用 MCP 内存工具。

### 模式

```markdown
## 记忆集成

当你开始会话时：
- 使用你的角色和当前项目作为搜索词回忆以前会话的相关上下文
- 查看任何标记有你代理名称的记忆，以便从中断处继续

当你做出关键决策或完成交付成果时：
- 用描述性标签（你的代理名称、项目、主题）记住决策或交付成果
- 包括足够的上下文，以便未来的会话——或不同的代理——可以理解做了什么以及为什么

当你交接给另一个代理时：
- 记住为接收代理标记的交付成果
- 包括交接元数据：你完成的内容、待处理的内容以及下一个代理需要知道的内容

当某些事情失败并且你需要恢复时：
- 搜索最后一个已知良好状态
- 使用回滚恢复到该点，而不是从头开始重建
```

### 代理如何使用这些

当给出这些指令时，LLM 将自动使用 MCP 内存工具：

- `remember` —— 用标签存储决策、交付成果或上下文快照
- `recall` —— 通过关键字、标签或语义相似性搜索相关记忆
- `rollback` —— 当出问题时恢复到以前的状态
- `search` —— 在会话和代理之间查找特定记忆

无需对代理文件进行代码更改。无需编写 API 调用。MCP 工具处理一切。

## 示例：增强后端架构师

查看 [backend-architect-with-memory.md](backend-architect-with-memory.md) 获取完整示例——标准后端架构师代理添加了记忆集成部分。

## 示例：记忆驱动的工作流程

查看 [../../examples/workflow-with-memory.md](../../examples/workflow-with-memory.md) 获取增强持久记忆的初创公司 MVP 工作流程，展示代理如何通过记忆传递上下文而不是复制粘贴。

## 提示

- **一致标记**：在每个记忆中使用代理名称和项目名称作为标签。这使得回忆可靠。
- **让 LLM 决定什么是重要的**：记忆指令是指导，不是严格的规则。LLM 将弄清楚何时记住以及回忆什么。
- **回滚是杀手功能**：当现实核查员未通过交付成果时，原始代理可以回滚到其最后一个检查点，而不是尝试手动撤消更改。