知识与文档 · Model Context Protocol 参考服务器

Memory MCP Server

用本地知识图谱保存实体、关系和观察,适合小范围可检查的长期上下文。

CodexClaude Codestdio

Memory MCP Server 是什么?

Memory MCP Server 是一个本地知识图谱记忆服务。它把项目中的实体、关系和稳定事实保存成可查询记录,让后续任务复用背景,而不是保存整段聊天。

一句话理解用本地知识图谱保存实体、关系和观察,适合小范围可检查的长期上下文。

为什么需要它?

把可复用事实整理成结构化实体和关系,减少每次任务重复说明相同背景。

接入前,AI 只能依赖你粘贴的材料、截图或旧上下文;接入后,它可以在你授权的范围内调用真实工具,并把结果、来源和状态带回当前任务。

核心能力

01
创建与查询实体
02
维护实体之间的关系
03
追加和删除可追踪的观察记录

适合谁?怎么用?

适合使用
  • 保存可复用的项目事实和关系
  • 需要保存项目术语、对象关系和稳定事实,又不希望把全部聊天记录当作记忆的用户。
  • 能调用查询工具并看到返回结构;空结果与调用失败要分开。后续经确认写入测试实体时,再读回并检查 MEMORY_FILE_PATH 指定的 JSONL 文件。
不适合
  • 不适合保存密码、Token、客户资料或未经确认的推断。
  • 长期记忆可能累积个人、客户或内部项目信息
  • 错误事实会在后续任务中被重复使用

怎么接入?

  1. 1
    准备

    确认 Node.js 与 npx 可用,准备可写的本地测试目录。

  2. 2
    授权

    按下方命令登记服务,并用 MEMORY_FILE_PATH 固定 JSONL 文件位置。

  3. 3
    连接

    重新打开任务后,先用 search_nodes 查询测试名称;空库没有匹配项是正常结果。

  4. 4
    开始使用

    另行允许写入后才能创建测试实体,再读回实体并核对指定文件;首次只读检查不要求写入。

安装命令

添加 Memory MCP Server

codex mcp add memory --env MEMORY_FILE_PATH=C:/mcp-demo/memory.jsonl -- npx -y @modelcontextprotocol/server-memory

Windows 示例:先创建自己可写的 C:/mcp-demo 目录,或将其换成已有测试目录的绝对路径。MEMORY_FILE_PATH 是项目支持的存储变量;不要依赖包目录中的默认文件。首次查询不会自动产生记忆文件;写入测试记录后可用 PowerShell 的 Get-Content -LiteralPath C:/mcp-demo/memory.jsonl 检查内容。本轮只核对文档,未安装运行。

检查命令

确认 MCP 已经登记

codex mcp list

接入前准备

  • Node.js 与 npx
  • 明确记忆文件保存位置和备份规则
  • 先定义哪些事实允许长期保存

官方帮助

官方文档与仓库Model Context Protocol 参考服务器问题反馈在 GitHub Issues 获取帮助

第一次调用示例

登记完成后,新开一个任务,按下面任务限定调用范围,先说清目标、范围和停止条件。

发给 Codex

第一次小范围任务

请用 Memory MCP 的 search_nodes 查询 mcp-demo;只返回匹配实体和关系,不创建或修改任何记录。新建的空记忆库返回空结果也是正常结果。
怎样算成功

能调用查询工具并看到返回结构;空结果与调用失败要分开。后续经确认写入测试实体时,再读回并检查 MEMORY_FILE_PATH 指定的 JSONL 文件。

  1. 首次只读检查:查询 mcp-demo,区分空结果和调用失败。
  2. 后续写入练习需另行确认:只在指定测试 JSONL 中创建 mcp-demo,记录教学事实“构建命令为 npm run build”,不记录真实项目或个人信息。
  3. 写入获准并完成后,读回 mcp-demo,并用 Get-Content 核对同一个 MEMORY_FILE_PATH 文件。
  4. 清理也属于写入:经确认后只删除本轮 mcp-demo 实体,再查询确认它不再存在;不要清空整个记忆库。

权限与安全

凭证与连接方式

本地 stdio;MEMORY_FILE_PATH 指定持久化 JSONL 文件,首次先做只读查询。

  • 长期记忆可能累积个人、客户或内部项目信息
  • 错误事实会在后续任务中被重复使用
  • 需要备份、删除和定期复核机制

用小贺API和 MCP,把真实工具接进工作流

从一个 MCP、一个只读任务开始,先把连接、权限和结果验证清楚。

多平台支持兼容主流 MCP 客户端接入方法清楚命令与自助指令分开权限边界明确先只读再扩大范围
进入小贺API