BingoAgentTouch/Personal_MCP

README 摘要

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 明确告警 ——不会假装正常。 记忆分层 写入顺序: store turn (逐轮) → create fragment (打包几轮为一个片段,自动算 embedding) → create daily summary / upsert topic (汇总)。 重要:存储根是相对 CWD 的 ( path.resolve("memory/...") )。服务器进程以哪个目录为工作目录,记忆就写在那个目录的 memory/ 下。让宿主(Claude Code 等)以「你想要记忆的项目根」为 CWD 启动本服务器。 安装 & 构建 下载安装到某个路径 （注意，CherryStudio用户可能由于该GUI的路径问题或管道问题无法直接使用，请谨慎安装） 要求 Node ≥ 20(开发用 22 验证)。 从 npm 安装（发布后） 发布者注意：npm 裸名 memory-mcp-server / memory-mcp 均已被占用，发布前必须把 package.json 的 name 改为 scoped 名（ @ /memory-mcp-server ）并 npm login 后 npm publish --access public 。 各 harness 接入片段（参数化） 数据根约定（最重要） ：记忆库存储在 服务器进程 CWD 下的 memory/ 目录。以你想让记忆归属的项目根作为 cwd 启动——下面两个配置的 cwd 字段都是关键。 DeepSeek Harness（DSH）： /.dsh/profiles/ /cordis.patch.yml Claude Code：项目根的 .mcp.json 或直接给 Claude Code 文件已安装的路径，让其智能注册，然后重启 Claude Code。 发布友好开关 ：服务器启动时会向 CWD 项目的 harness 规则文件（AGENTS.md 等）注入「记忆使用规范」。对他人机器这是侵入性行为——设 MEMORY SKIP INJECT=1…

分类