首页/新闻资讯/正文详情

给Cursor和Claude Code装上长期记忆:agent-memory通过MCP接入的完整教程

发布时间:2026/9/24 14:06:30 来源:云帆数科 栏目:资讯中心
给Cursor和Claude Code装上长期记忆:agent-memory通过MCP接入的完整教程
给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),仅供参考

相关推荐

AI 时代,PostgreSQL 正在发生什么变化?
AI 时代,PostgreSQL 正在发生什么变化?

引言 过去两年,AI 几乎重塑了整个技术行业的话题中心。 RAG、Agent、向量数据库、GraphRAG、AI Coding……新概念层出不穷。与此同时,数据库领域也在经历一场静水深流的变革。 2025 年,PostgreSQL 在全球开发者中的使用率达到了创纪录的 5… · 2026/9/24 14:06:24

Kornia 模糊增强 border_type 统一解析:RandomBoxBlur 与 BorderType 枚举的兼容性修复
Kornia 模糊增强 border_type 统一解析:RandomBoxBlur 与 BorderType 枚举的兼容性修复

计算机视觉人工智能深度学习图像处理 【免费下载链接】kornia 🐍 Geometric Computer Vision Library for Spatial AI 项目地址: https://gitcode.com/gh_mirrors/ko/kornia 点击查看 免费下载 本篇围绕 Kornia 仓库变更片段 changelog.d/4591.fixed.md… · 2026/9/24 14:06:24

合肥市芜湖市马鞍山市企业HR系统选型:深耕本地服务落地数字化
合肥市芜湖市马鞍山市企业HR系统选型:深耕本地服务落地数字化

合肥市、芜湖市、马鞍山市作为皖江城市带承接产业转移示范区的核心枢纽,是安徽省工业经济、产业集群、实体经济的核心承载地。三地产业互补、联动发展,汇聚了新能源、汽车制造、高端装备、钢铁新材料、智能机器人等支柱产业,聚集了大量中大型… · 2026/9/24 14:06:18

PaddleSpeech 流式 TTS 推理与实时播放:stream_play_tts 模块原理与实践
PaddleSpeech 流式 TTS 推理与实时播放:stream_play_tts 模块原理与实践

人工智能语音音频NLP媒体生成 【免费下载链接】PaddleSpeech Easy-to-use Speech Toolkit including Self-Supervised Learning model, SOTA/Streaming ASR with punctuation, Streaming TTS with text frontend, Speaker Verification System, End-to-End Speech Translation … · 2026/9/24 14:43:18

ToastFish 完整指南:用 Windows 通知栏快速免费背单词
ToastFish 完整指南:用 Windows 通知栏快速免费背单词

ToastFish 完整指南:用 Windows 通知栏快速免费背单词 【免费下载链接】ToastFish 一个利用摸鱼时间背单词的软件。 项目地址: https://gitcode.com/GitHub_Trending/to/ToastFish Windows 10 及以上系统右下角弹出的通知,不止能用来提醒日程。开… · 2026/9/24 14:43:18

DevilutionX GDB 调试增强:pretty-printer 的加载方式、配置实战与实现原理
DevilutionX GDB 调试增强:pretty-printer 的加载方式、配置实战与实现原理

游戏开发 【免费下载链接】DevilutionX Diablo build for modern operating systems 项目地址: https://gitcode.com/gh_mirrors/de/DevilutionX 点击查看 免费下载 导读 DevilutionX(暗黑破坏神 1 的现代操作系统移植版)在仓库中内置了一套… · 2026/9/24 14:42:58

RGBD相机视觉检测:MV-EB435i深度对齐与点云融合实践
RGBD相机视觉检测:MV-EB435i深度对齐与点云融合实践

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/9/24 14:42:46

现在口碑好的AI论文写作工具有哪些品牌?聊聊真实使用体验
现在口碑好的AI论文写作工具有哪些品牌?聊聊真实使用体验

每到期末、毕业答辩、课题申报阶段,很多学生都会陷入论文写作的困境:选题毫无头绪、大纲搭建逻辑混乱、正文撰写耗时长、参考文献格式出错、查重重复率偏高、AIGC检测告警、本校论文排版标准复杂。依靠纯人工从零开始撰写、一遍遍修改格式和降重&#xf… · 2026/9/24 14:42:46

2026 人才测评工具优选指南:核心选型标准全梳理
2026 人才测评工具优选指南:核心选型标准全梳理

一、选型前先想清楚一件事:测评工具解决什么问题引文/摘要企业在人才决策中面临的核心矛盾,往往是主观判断与客观数据之间的断层。2026年,人才测评工具已从单纯的“筛人”演变为组织人才数据中台的基础组件。然而工具品类繁多,能力… · 2026/9/24 14:42:40

基于YOLOv8的渔船作业监控系统:从环境搭建到边缘部署全流程
基于YOLOv8的渔船作业监控系统:从环境搭建到边缘部署全流程

简介:这是一套面向计算机、人工智能、自动化等专业学生与教师的毕业设计级项目资源,围绕YOLOv8实现渔船作业监控系统,可用于毕设、课程设计、大作业或项目立项演示。压缩包共97个文件,约24.21MB,以70个Python源码文件为… · 2026/9/24 0:00:13

1D-CNN时间序列建模实战:从Conv1d原理到工业落地
1D-CNN时间序列建模实战:从Conv1d原理到工业落地

简介:面向时间序列数据建模的一维卷积神经网络完整实现,适合深度学习入门者及需要快速验证时序模型的研究者,能够从音频、文本、传感器或股价等序列中挖掘局部特征与时间依赖。压缩包体积很小,只有3KB,内含3个Python脚… · 2026/9/24 0:00:26

柔软的L:汉语语流中被忽视的舌肌张力控制
柔软的L:汉语语流中被忽视的舌肌张力控制

1. 这个“L”不是字母表里的L,而是舌尖上的L最近在几个方言群和语音教学社群里,反复看到有人发一句:“也说字母L:柔软的长舌”。初看以为是英语发音课笔记,点开才发现全是方言爱好者、播音系学生、语言康复师甚至戏曲演… · 2026/9/24 0:00:44

了解更多?预约专属演示

我们的顾问将为您一对一讲解产品与方案

企业微信二维码