RMS Memory MCP：AI 编程助手本地记忆库

项目简介

RMS Memory MCP 是一个面向 AI 编程助手的持久化、本地优先记忆服务。它把项目上下文集中存放在独立的 Markdown vault 中，让 Cursor、Zed、Claude Code、OpenCode 等支持 MCP 的 IDE 或代理都能读写同一份记忆，减少重复解释架构决策、系统需求和用户偏好。项目不收集数据或使用统计，没有账号、许可证检查和分析，笔记、代码、查询与设置保留在本机。

主要功能

• 集中式 vault：项目上下文放在仓库之外，不污染 .mcp 文件。
• 混合检索：基于 LanceDB 的嵌入式向量搜索与 Tantivy 全文搜索，支持 vault、code、all 范围，并用 Reciprocal Rank Fusion 合并结果。
• 多语言语义解析：默认使用 fastembed-rs 与 multilingual-e5-small，可通过 rms-memory embedding use 切换内置模型或本地 Ollama 模型。
• Markdown 与代码索引：基于 pulldown-cmark 的 AST 分块保留代码块、列表与父标题关系；可选 Tree-sitter 索引 Rust、Go、JS/JSX、TS/TSX、Python、C/C++、Java、Ruby、Swift、C#、PHP、Kotlin、SQL、HTML、CSS 和 Vue <script> 块。
• 知识图谱：通过 MCP rms_graph 维护 Markdown/代码关系，支持邻居、路径、快照和变更操作。
• 会话连续性：提供 rms_checkpoint_save/done/load/query、rms_overview、MCP resources rms://<project>/… 和 session_start、save_progress、record_decision 等 prompts。
• 知识生命周期：用 frontmatter 的 status、supersedes、valid_* 控制召回，支持软替代、Doctor 新鲜度检查和 rms-memory prune 归档。
• Obsidian 集成：rms-memory projects attach-obsidian <PATH> 以严格只读方式索引现有 Obsidian vault；rms-memory import --obsidian <DIR> 可复制到项目 vault。
• 本地 HTTP 传输：rms-memory serve --http 在 127.0.0.1:7337/mcp 提供 MCP Streamable HTTP，使用 ~/.rms-memory/http-token 中的 bearer token。
• 凭据拒绝：rms_write 和检查点工具会拒绝包含常见令牌格式或 PEM 私钥的文本，并指出类型和行号，但不显示具体值。
• 更新与回滚：rms-memory update 校验签名清单、大小和 sha256，冒烟测试后原子替换二进制，并保留上一版本供 --rollback 使用。
• 可选 GUI：付费 Tauri 桌面应用 RMS Memory GUI 提供可视化 Markdown/图谱编辑、Git 与 Vault 同步、Doctor 面板和 AI 辅助 Wiki 生成；MCP server 保持免费独立。

安装与使用

可从发布页下载 macOS .tar.gz、Windows .zip、Linux x64/ARM64 的 .tar.gz 或 .rpm。安装后运行：

rms-memory install

该命令会扫描系统并接入支持的 IDE。需要本地 HTTP 服务时运行：

rms-memory serve --http

服务端点为 127.0.0.1:7337/mcp，令牌位于 ~/.rms-memory/http-token。如使用配套 GUI，可运行 rms-memory gui 安装并打开。更新使用 rms-memory update，回滚使用 rms-memory update --rollback。

注意事项

• 首次使用嵌入模型时会从 Hugging Face 下载一次；嵌入在本机计算，笔记不会发送给 AI 服务。
• doctor 和 rms_doctor 每天最多检查一次新版本，可通过 RMS_MEMORY_NO_UPDATE_CHECK=1 关闭。
• 凭据拒绝不能作为绝对保证，限制见 SECURITY.md。
• Obsidian attach 模式严格只读，RMS Memory 不会创建、修改或删除该 vault 中的文件。
• 配套 GUI 是付费桌面应用，但不是使用 MCP server 的必需条件。

本作品整理自 GitHub 开源项目 max-ramas/rms-memory-mcp，原作者 @max-ramas，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。