MCP 服务端与 AI 编码智能体
MCP 服务器与 AI 编码智能体
相关源文件
本章引用的主要源码文件：
.agents/plugins/marketplace.json.claude-plugin/marketplace.json.cursor-plugin/marketplace.jsondocs/cookbooks/frameworks/gemini-3-with-mem0-mcp.mdxdocs/integrations.mdxdocs/integrations/chatdev.mdxdocs/integrations/claude-code.mdxdocs/integrations/codex.mdxdocs/integrations/cursor.mdxdocs/integrations/hermes.mdxdocs/platform/features/mcp-integration.mdxdocs/platform/mem0-mcp.mdxmem0-plugin/.claude-plugin/plugin.jsonmem0-plugin/.codex-mcp.jsonmem0-plugin/.codex-plugin/plugin.jsonmem0-plugin/.cursor-plugin/plugin.jsonmem0-plugin/README.mdmem0-plugin/hooks/cursor-hooks.jsonmem0-plugin/hooks/hooks.jsonmem0-plugin/scripts/_identity.pymem0-plugin/scripts/_identity.shmem0-plugin/scripts/block_memory_write.shmem0-plugin/scripts/capture_compact_summary.pymem0-plugin/scripts/on_pre_compact.pymem0-plugin/scripts/on_pre_compact.shmem0-plugin/scripts/on_session_start.shmem0-plugin/scripts/on_stop.shmem0-plugin/scripts/on_stop_codex.shmem0-plugin/scripts/on_task_completed.shmem0-plugin/scripts/on_user_prompt.shmem0-plugin/skills/mem0-mcp/SKILL.mdmem0-plugin/skills/mem0/SKILL.mdmem0-plugin/skills/mem0/references/api-reference.mdmem0-plugin/skills/mem0/references/architecture.mdmem0-plugin/skills/mem0/references/features.mdmem0-plugin/skills/mem0/references/integration-patterns.mdmem0-plugin/skills/mem0/references/quickstart.md
Mem0 仓库提供了一个专门的模型上下文协议（MCP） 服务器，以及针对 Claude Code、Cursor 和 Codex 等 AI 编码助手的专用插件。这种集成使得 AI 智能体能够跨编码会话维护持久上下文，记住架构决策，并通过将 Mem0 作为远程记忆层来回忆用户偏好。
MCP 服务器实现
Mem0 MCP 服务器充当 AI 客户端与 Mem0 记忆系统之间的标准化接口。它将 Mem0 的能力以工具的形式暴露出来，允许智能体自主决定何时保存、搜索或更新信息 docs/platform/mem0-mcp.mdx:16-18。
核心 MCP 工具
该服务器向 AI 客户端暴露了 11 个记忆工具 docs/platform/mem0-mcp.mdx:36-50：
| 工具名称 | 描述 |
|---|---|
add_memory | 保存用户/智能体的文本或对话历史。 |
search_memories | 在现有记忆中执行语义搜索，支持过滤。 |
get_memories | 使用结构化过滤和分页列出记忆。 |
update_memory | 在确认 ID 后覆盖某条记忆的文本。 |
delete_memory | 通过 memory_id 删除单条记忆。 |
list_entities | 枚举存储在 Mem0 中的用户/智能体/应用/运行实例。 |
list_events | 列出记忆操作事件，支持过滤和分页。 |
数据流：MCP 工具执行
下图展示了 MCP 工具调用如何从编码智能体流向 Mem0 平台。
图：MCP 工具执行流程
来源： docs/platform/mem0-mcp.mdx:18-32, docs/platform/features/mcp-integration.mdx:72-77。
AI 编码智能体集成
Mem0 提供了一个统一的插件（mem0-plugin），支持多种 AI 编码环境。这些集成通常包含 MCP 服务器、生命周期钩子和智能体技能 docs/integrations/claude-code.mdx:8-13。
支持的平台
| 平台 | 集成方式 | 包含的功能 |
|---|---|---|
| Claude Code / Cowork | 插件市场（/plugin install mem0） | MCP 工具、生命周期钩子、SDK 技能 mem0-plugin/README.md:35-49 |
| Cursor | 市场或 .cursor/mcp.json | MCP 工具、生命周期钩子（仅限市场方式） mem0-plugin/README.md:109-137 |
| OpenAI Codex | 通过市场 CLI 侧载 | MCP 工具、记忆协议技能、可选钩子 docs/integrations/codex.mdx:49-81 |
生命周期钩子
生命周期钩子通过在开发工作流的特定节点触发操作，实现记忆管理的自动化 mem0-plugin/hooks/hooks.json:1-72。
- SessionStart：执行
on_session_start.sh脚本，加载先前的记忆作为启动上下文mem0-plugin/hooks/hooks.json:3-14。 - UserPromptSubmit：触发
on_user_prompt.sh脚本，注入一个决策规则，告知智能体何时进行搜索mem0-plugin/scripts/on_user_prompt.sh:4-10。 - PreCompact：触发
on_pre_compact.sh脚本，在上下文窗口截断前存储会话摘要mem0-plugin/hooks/hooks.json:26-36。 - TaskCompleted：运行
on_task_completed.sh脚本，提取并存储关键学习成果mem0-plugin/hooks/hooks.json:60-70。
智能体技能
技能是指令，用于“教导”智能体如何有效使用 Mem0。
- Mem0 SDK 技能：指导 AI 如何将 Mem0 SDK（Python/TS）集成到用户应用中
mem0-plugin/README.md:157-157。 - Mem0 MCP 记忆协议：一个专门的技能（
SKILL.md），指示智能体使用特定的metadata.type值，例如decision、anti_pattern和user_preferencemem0-plugin/skills/mem0-mcp/SKILL.md:91-98。
系统架构：代码实体映射
下图将“记忆”和“上下文”等自然语言概念，与插件中使用的具体配置和脚本实体关联起来。
图：记忆上下文到代码实体的映射
来源： mem0-plugin/.claude-plugin/plugin.json:1-13, mem0-plugin/hooks/hooks.json:1-72, mem0-plugin/skills/mem0-mcp/SKILL.md:1-100。
配置与部署
MCP 服务器主要采用云托管方式，以便于使用，但需要在本地环境中进行认证配置。
- 认证：在 shell 中导出
MEM0_API_KEY环境变量，或在config.toml/.mcp.json文件中进行配置mem0-plugin/README.md:14-22。 - 直接 MCP：使用
npx mcp-add命令快速建立连接，该命令指向https://mcp.mem0.ai/mcpdocs/platform/mem0-mcp.mdx:22-32。 - 自定义过滤：指示智能体在过滤对象的根级别使用
AND/OR操作符，并在嵌套的元数据对象中使用mem0-plugin/skills/mem0-mcp/SKILL.md:48-51。
来源：
docs/platform/mem0-mcp.mdxdocs/integrations/claude-code.mdxdocs/integrations/codex.mdxmem0-plugin/README.mdmem0-plugin/hooks/hooks.jsonmem0-plugin/scripts/on_user_prompt.shmem0-plugin/skills/mem0-mcp/SKILL.mdmem0-plugin/.claude-plugin/plugin.json