给Cursor和Claude Code装上长期记忆agent-memory通过MCP接入的完整教程【免费下载链接】agent-memoryMemory 是一款面向 AI 智能体的长期记忆模块为运行在 openJiuwen 框架上的智能体提供记忆提取、存储、检索与迁移能力。项目地址: https://gitcode.com/openJiuwen/agent-memoryagent-memory 是一款开源的智能体长期记忆系统本教程将手把手教你通过 MCPModel Context Protocol把它接入 Cursor 和 Claude Code让 AI 编程助手跨会话记住你的偏好、项目约定与历史决策告别失忆烦恼。为什么需要给编程助手加长期记忆用 Cursor 或 Claude Code 写代码时你肯定经历过这些场景上周明确说过项目用 Python 3.11 ruff换个会话它又开始给你上 Java 风格修过的 Bug、确认过的技术选型每次新会话都要重新解释一遍项目里散落一堆MEMORY.md、笔记文件AI 只能靠猜去翻。agent-memory 就是为此设计的它不是简单的往文件里追加文本而是一套融合记忆提取、分层存储、混合检索与自演进的记忆底座——对话进来后系统会自动抽取事实、精炼抽象、建立关联并在你提问时通过关键词 向量的混合召回把最相关的记忆喂给模型。接入后你能获得什么agent-memory 的 MCP 接入面源码位于 jiuwen_memory_entry/mcp_server/会把记忆能力注册为36 个memory_*工具与 HTTP/CLI 共享同一套契约覆盖常用场景类别代表工具用途数据面memory_add/memory_search/memory_list/memory_get写入、召回、查看记忆任务面memory_evolve/memory_submit_ingest触发记忆自演进、摄入新内容管理面memory_admin_get/ Space 系列工具配置、多空间隔离与共享对模型来说这意味着它可以在对话中自主决定何时写入、何时召回记忆而不需要你手动操作。一键安装获取并启动 MCP 服务整个过程只需三步全程不超过 5 分钟。第 1 步克隆仓库并安装 MCP 依赖git clone https://gitcode.com/openJiuwen/agent-memory cd agent-memory pip install .[mcp]⚠️ 注意MCP 依赖要求mcpSDK 版本 22.x 已对 FastMCP 改名按上面方式安装即可自动锁定正确版本。第 2 步启动 MCP 服务仓库提供了启动脚本 scripts/run-mcp.sh本地开发推荐先用 dev 认证模式固定测试身份、免配置凭据JIUWEN_MEMORY_MCP_AUTH_MODEdev scripts/run-mcp.sh第 3 步用 Inspector 可视化验证可选但推荐JIUWEN_MEMORY_MCP_AUTH_MODEdev npx modelcontextprotocol/inspector \ python jiuwen_memory_entry/mcp_server/__main__.py打开 Inspector 网页在 Tools 页应能看到全部 36 个memory_*工具说明服务正常。给 Claude Code 接入3 行配置搞定Claude Code 支持 stdio 方式的 MCP 服务器在项目目录或用户级配置中登记即可。以 Claude Desktop 风格的claude_desktop_config.json为例{ mcpServers: { agent-memory: { command: python, args: [仓库路径/jiuwen_memory_entry/mcp_server/__main__.py], env: { PYTHONPATH: 仓库路径;仓库路径/jiuwen_memory_entry/core, JIUWEN_MEMORY_MCP_AUTH_MODE: dev } } } }把仓库路径替换为你本地克隆的目录保存后重启 Claude Code输入/mcp即可确认agent-memory服务器已连接。此后你在对话里随口一句以后这个项目里测试都用 pytest模型就会调用memory_add把它存下来。在 Cursor 中配置 MCP 记忆工具Cursor 的 MCP 配置位于~/.cursor/mcp.json或 设置 → MCP写法几乎一致{ mcpServers: { agent-memory: { command: python, args: [仓库路径/jiuwen_memory_entry/mcp_server/__main__.py], env: { PYTHONPATH: 仓库路径;仓库路径/jiuwen_memory_entry/core, JIUWEN_MEMORY_MCP_AUTH_MODE: dev } } } }配置完成后在 Cursor 的 Agent 对话中工具列表里会出现memory_add、memory_search等工具模型可自主调用。5 分钟验证写入并召回一条记忆接入后建议立刻做一次闭环验证确认写入 → 召回链路通畅写入让助手调用memory_add内容填我喜欢喝咖啡scope 填{org:local,user:developer}记下返回的id召回调用memory_searchquery 填喝什么context 的 scope 与写入时一致——返回的items中应包含刚写入的那条附带相关性得分进阶拿id继续memory_get查看详情、memory_evolve触发演进返回job_id可用memory_job_status查询进度。三步走通你的编程助手就真正长记性了。常见问题与注意事项重启后记忆清空默认 OFFLINE 模式使用纯内存栈进程退出数据即清空。生产使用请启动时传入真实后端配置例如scripts/run-mcp.sh examples/config.yml可参考 examples/config.yml 及 docs/zh/安装指导/部署方式概览.md。dev 模式能上生产吗不能。dev 模式仅固定local/developer测试身份且只允许回环绑定适合本地功能测试生产环境请使用required认证模式并接入正式认证器fail-closed 设计未装配认证器时业务调用一律拒绝。调用报 cannot be called from a running event loop这是旧版事件循环冲突问题当前版本已通过工作线程隔离修复升级到最新代码即可。工具参数对不上MCP 面与 HTTP/CLI 共享同一套参数契约jiuwen_memory_entry/core/api_contract.py如有出入请以最新 docs/features/F03-mcp-surface.md 为准。延伸阅读docs/features/F03-mcp-surface.mdMCP 接入面完整设计与调用路径README_zh.md项目全貌、分层记忆架构与快速上手jiuwen_memory_entry/mcp_server/MCP 服务源码含 stdio 与 Streamable HTTP 两种传输docs/zh/安装指导/部署方式概览.mdSDK / HTTP / CLI / MCP 各形态选型指南至此Cursor 与 Claude Code 已接入 agent-memory 长期记忆能力写入自动提取、召回混合排序、记忆随使用自演进。接下来你可以试着在真实项目里让它记住你的代码规范和踩坑记录体验越用越懂你的编程助手 【免费下载链接】agent-memoryMemory 是一款面向 AI 智能体的长期记忆模块为运行在 openJiuwen 框架上的智能体提供记忆提取、存储、检索与迁移能力。项目地址: https://gitcode.com/openJiuwen/agent-memory创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考