Memory MCP Server 是什么?
Memory MCP Server 是一个本地知识图谱记忆服务。它把项目中的实体、关系和稳定事实保存成可查询记录,让后续任务复用背景,而不是保存整段聊天。
一句话理解用本地知识图谱保存实体、关系和观察,适合小范围可检查的长期上下文。
为什么需要它?
把可复用事实整理成结构化实体和关系,减少每次任务重复说明相同背景。
接入前,AI 只能依赖你粘贴的材料、截图或旧上下文;接入后,它可以在你授权的范围内调用真实工具,并把结果、来源和状态带回当前任务。
核心能力
创建与查询实体
把真实信息带回当前任务,减少反复复制和手动核对。
维护实体之间的关系
在明确授权范围内调用工具,并保留执行过程和结果。
追加和删除可追踪的观察记录
回读来源、状态与限制,方便继续处理和人工验收。
适合谁?怎么用?
- 保存可复用的项目事实和关系
- 需要保存项目术语、对象关系和稳定事实,又不希望把全部聊天记录当作记忆的用户。
- 能查询到实体、关系和观察的来源,并能删除测试记忆。
- 不适合保存密码、Token、客户资料或未经确认的推断。
- 长期记忆可能累积个人、客户或内部项目信息
- 错误事实会在后续任务中被重复使用
怎么接入?
- 1准备
检查
@modelcontextprotocol/server-memory当前 README 与包版本。 - 2授权
以
npx -y @modelcontextprotocol/server-memory启动一次本地 stdio 服务。 - 3连接
在客户端登记命令,并把存储文件放在受控目录。
- 4开始使用
重新加载后创建一个不含敏感信息的测试实体。
安装命令
添加 Memory MCP Server
codex mcp add memory -- npx -y @modelcontextprotocol/server-memory只保存长期稳定且允许留存的信息,先用不含隐私的测试实体验证。
检查命令
确认 MCP 已经登记
codex mcp list不想自己操作终端时,把下面整段发给 Codex。它会先核对官方说明和前置条件,遇到凭证或占位符会停下来询问。
发给 Codex
自助接入 Memory MCP Server
请帮我在当前电脑上接入并验证 Memory MCP Server。
官方来源:https://github.com/modelcontextprotocol/servers/tree/main/src/memory
目标接入命令:codex mcp add memory -- npx -y @modelcontextprotocol/server-memory
请按以下步骤执行:
1. 先阅读官方 README,核对当前推荐接入方式与上述命令。如果官方说明已经变化,先告诉我差异,不要盲目执行旧命令。
2. 检查运行环境、登录状态、Token、项目 ID、允许访问路径等前置条件。不要在输出中显示任何凭证,也不要把凭证写入仓库。
3. 如果命令中有需要替换的占位符,先列出需要我提供的值并停下来,不要自行猜测。
4. 条件满足后执行接入命令,再运行 codex mcp list,确认 Memory MCP Server 已登记,并回报实际服务名、传输方式和检查结果。
5. 用下面这个只读任务验证连接:请用 Memory MCP 保存这个项目的构建命令、部署入口和验收规则;只保存稳定事实,不写入个人隐私。
6. 不要创建、修改、删除、发送内容,也不要连接生产环境;需要写权限或更高权限时先征求我确认。- 复制完整指令,发给一个有终端和当前项目访问权限的 Codex 任务。
- Codex 会先核对官方来源和本机环境;遇到 Token、项目 ID、路径或其他占位符时,应停下来向你确认。
- 接入后运行
codex mcp list,再用 Memory MCP Server 的只读首测任务回读结果。
第一次调用示例
登记完成后,新开一个任务,先用下面这句做只读验证,把目标、范围和停止条件一次说清楚。
发给 Codex
第一次只读任务
请用 Memory MCP 保存这个项目的构建命令、部署入口和验收规则;只保存稳定事实,不写入个人隐私。怎样算成功
能查询到实体、关系和观察的来源,并能删除测试记忆。
- 先查询已有实体,避免重复创建。
- 只写入长期稳定、可以核验的事实。
- 通过关系查询检查实体是否被正确连接。
- 删除测试实体并确认存储文件真实更新。
权限与安全
凭证与连接方式
本地 stdio;数据会长期留存,先明确哪些信息允许写入。
- 长期记忆可能累积个人、客户或内部项目信息
- 错误事实会在后续任务中被重复使用
- 需要备份、删除和定期复核机制
