Memory MCP Server 是什么?
Memory MCP Server 是一个本地知识图谱记忆服务。它把项目中的实体、关系和稳定事实保存成可查询记录,让后续任务复用背景,而不是保存整段聊天。
为什么需要它?
把可复用事实整理成结构化实体和关系,减少每次任务重复说明相同背景。
接入前,AI 只能依赖你粘贴的材料、截图或旧上下文;接入后,它可以在你授权的范围内调用真实工具,并把结果、来源和状态带回当前任务。
核心能力
适合谁?怎么用?
- 保存可复用的项目事实和关系
- 需要保存项目术语、对象关系和稳定事实,又不希望把全部聊天记录当作记忆的用户。
- 能调用查询工具并看到返回结构;空结果与调用失败要分开。后续经确认写入测试实体时,再读回并检查 MEMORY_FILE_PATH 指定的 JSONL 文件。
- 不适合保存密码、Token、客户资料或未经确认的推断。
- 长期记忆可能累积个人、客户或内部项目信息
- 错误事实会在后续任务中被重复使用
怎么接入?
- 1准备
确认 Node.js 与 npx 可用,准备可写的本地测试目录。
- 2授权
按下方命令登记服务,并用 MEMORY_FILE_PATH 固定 JSONL 文件位置。
- 3连接
重新打开任务后,先用 search_nodes 查询测试名称;空库没有匹配项是正常结果。
- 4开始使用
另行允许写入后才能创建测试实体,再读回实体并核对指定文件;首次只读检查不要求写入。
添加 Memory MCP Server
codex mcp add memory --env MEMORY_FILE_PATH=C:/mcp-demo/memory.jsonl -- npx -y @modelcontextprotocol/server-memoryWindows 示例:先创建自己可写的 C:/mcp-demo 目录,或将其换成已有测试目录的绝对路径。MEMORY_FILE_PATH 是项目支持的存储变量;不要依赖包目录中的默认文件。首次查询不会自动产生记忆文件;写入测试记录后可用 PowerShell 的 Get-Content -LiteralPath C:/mcp-demo/memory.jsonl 检查内容。本轮只核对文档,未安装运行。
确认 MCP 已经登记
codex mcp list不想自己操作终端时,把下面整段发给 Codex。它会先核对官方说明和前置条件,遇到凭证或占位符会停下来询问。
自助接入 Memory MCP Server
请帮我在当前电脑上接入并验证 Memory MCP Server。
官方来源:https://github.com/modelcontextprotocol/servers/tree/main/src/memory
目标接入命令:codex mcp add memory --env MEMORY_FILE_PATH=C:/mcp-demo/memory.jsonl -- npx -y @modelcontextprotocol/server-memory
请按以下步骤执行:
1. 先阅读官方 README,核对当前推荐接入方式与上述命令。如果官方说明已经变化,先告诉我差异,不要盲目执行旧命令。
2. 检查运行环境、登录状态、Token、项目 ID、允许访问路径等前置条件。不要在输出中显示任何凭证,也不要把凭证写入仓库。
3. 如果命令中有需要替换的占位符,先列出需要我提供的值并停下来,不要自行猜测。
4. 条件满足后执行接入命令,再运行 codex mcp list,确认 Memory MCP Server 已登记,并回报实际服务名、传输方式和检查结果。
5. 用下面这个只读任务验证连接:请用 Memory MCP 的 search_nodes 查询 mcp-demo;只返回匹配实体和关系,不创建或修改任何记录。新建的空记忆库返回空结果也是正常结果。
6. 不要创建、修改、删除、发送内容,也不要连接生产环境;需要写权限或更高权限时先征求我确认。- 复制完整指令,发给一个有终端和当前项目访问权限的 Codex 任务。
- Codex 会先核对官方来源和本机环境;遇到 Token、项目 ID、路径或其他占位符时,应停下来向你确认。
- 接入后运行
codex mcp list,再用 Memory MCP Server 的小范围测试任务回读结果。
第一次调用示例
登记完成后,新开一个任务,按下面任务限定调用范围,先说清目标、范围和停止条件。
第一次小范围任务
请用 Memory MCP 的 search_nodes 查询 mcp-demo;只返回匹配实体和关系,不创建或修改任何记录。新建的空记忆库返回空结果也是正常结果。能调用查询工具并看到返回结构;空结果与调用失败要分开。后续经确认写入测试实体时,再读回并检查 MEMORY_FILE_PATH 指定的 JSONL 文件。
- 首次只读检查:查询 mcp-demo,区分空结果和调用失败。
- 后续写入练习需另行确认:只在指定测试 JSONL 中创建 mcp-demo,记录教学事实“构建命令为 npm run build”,不记录真实项目或个人信息。
- 写入获准并完成后,读回 mcp-demo,并用 Get-Content 核对同一个 MEMORY_FILE_PATH 文件。
- 清理也属于写入:经确认后只删除本轮 mcp-demo 实体,再查询确认它不再存在;不要清空整个记忆库。
权限与安全
本地 stdio;MEMORY_FILE_PATH 指定持久化 JSONL 文件,首次先做只读查询。
- 长期记忆可能累积个人、客户或内部项目信息
- 错误事实会在后续任务中被重复使用
- 需要备份、删除和定期复核机制
