Personal_MCP

memory-mcp-server

一个给 LLM Agent(如 Claude Code)用的分层长期记忆 MCP 服务器。把对话沉淀成可语义检索的三层记忆,回答"我们上次聊到哪了"时能带出完整上下文。

> 当前版本:0.9.1

• 本地优先,可选 API:默认用本地 @xenova/transformers(多语言 MiniLM,384 维,零云依赖);也可切换到 OpenAI 兼容嵌入 API(MEMORY_EMBED_PROVIDER=api,免下载本地模型,见下文)。
• 分层回溯:命中片段(L1)时自动回填当天总结(L2)和主题脉络(L3)。
• 优雅降级:本地模型加载失败或 API 不可用时退回关键词(Jaccard)检索,并在 stderr 明确告警——不会假装正常。

---

记忆分层

memory/                     # 存储根,相对「服务器进程的工作目录(CWD)」
├── raw//turns.jsonl  # 原始对话,一字不改,全量保留
├── fragments//       # L1 任务→结果片段 (.md + .embedding 向量)
├── daily/.md         # L2 每日总结
└── topics/.md       # L3 跨天主题索引

写入顺序:store_turn(逐轮) → create_fragment(打包几轮为一个片段,自动算 embedding) → create_daily_summary / upsert_topic(汇总)。

> 重要:存储根是相对 CWD 的(path.resolve("memory/..."))。服务器进程以哪个目录为工作目录,记忆就写在那个目录的 memory/ 下。让宿主(Claude Code 等)以「你想要记忆的项目根」为 CWD 启动本服务器。

---

安装 & 构建

下载安装到某个路径

npm install
npm run build      # tsc → dist/

（注意，CherryStudio用户可能由于该GUI的路径问题或管道问题无法直接使用，请谨慎安装）

要求 Node ≥ 20(开发用 22 验证)。

从 npm 安装

npm install -g @bingo_touth/memory-mcp-server   # 全局安装
memory-mcp                                      # 直接以 stdio 启动
# 或临时运行：npx @bingo_touth/memory-mcp-server

> 本包发布名：@bingo_touth/memory-mcp-server（npm 裸名 memory-mcp-server / memory-mcp 均已被他人占用，故用 scoped 名）。

各 harness 接入片段（参数化）

数据根约定（最重要）：记忆库存储在服务器进程 CWD 下的 memory/ 目录。以你想让记忆归属的项目根作为 cwd 启动——下面两个配置的 cwd 字段都是关键。

DeepSeek Harness（DSH）：~/.dsh/profiles//cordis.patch.yml

- id: mcp-memory
  name: '@deepseek-ai/dsh-mcp-client'
  config:
    serverName: memory
    transport: stdio
    command: node
    args:
      - '<安装路径>/dist/index.js'   # 或全局安装后：["npx", "memory-mcp"]
    cwd: '<项目根>'                  # 记忆库落在这里的 memory/ 下
    toolCallTimeoutMs: 120000
    failOnStartupError: true

作为 DSH 插件安装（推荐，0.9.2+）

本包自带 DSH bundle 声明（dsh.bundle.patch），可省去手写整段接入配置：

npm i -g pnpm                        # dsh plugin 依赖 pnpm（一次性）
dsh plugin --profile web add @bingo_touth/memory-mcp-server

> pnpm 10 提示 ERR_PNPM_IGNORED_BUILDS（Ignored build scripts: protobufjs, sharp）时：这是 pnpm 10 默认拦截依赖构建脚本，会让 dsh plugin add 以非零退出、登记不生效。文本嵌入用不到这两个构建产物——编辑 ~/.dsh/profiles/web/pnpm-workspace.yaml（pnpm 已自动写好占位符），把 protobufjs / sharp 的 allowBuilds 置为 false，然后重跑一次 dsh plugin add 即可。

安装后 bundle 已注册 mcp-memory 行（默认 MEMORY_SKIP_INJECT=1、cwd=DSH 启动目录、failOnStartupError=false 不阻断启动）。唯一要做的：把服务器绝对路径换成你的——在你自己的 ~/.dsh/profiles//cordis.patch.yml 里用同 id 覆盖（用户层覆盖 bundle 层）：

- id: mcp-memory
  name: '@deepseek-ai/dsh-mcp-client'
  config:
    serverName: memory