适合谁
- 需要在不同 AI 编码工具间共享项目记忆的开发团队。
- 频繁开启新会话并丢失上下文的有经验开发者。
- 希望保留设计决策和推理过程的项目。
- 需要本地优先、隐私友好的记忆存储的用户。
- 使用多种 MCP 兼容代理并希望统一记忆层的用户。
M
66FMRS · C
Memorix 是一个功能丰富的本地优先 MCP 服务器，专为 AI 编码代理设计。它支持广泛的代理和客户端，提供多种记忆类型和工具，适合需要跨会话持久记忆的团队。安装和配置相对复杂，但文档详尽。非官方维护，但开源社区活跃。
Memorix 是一个开源、本地优先的跨代理记忆层，通过 MCP 为 AI 编码代理提供持久的项目记忆。它支持 Claude Code、Codex、Cursor、Windsurf、Copilot、Gemini CLI、OpenCode、OpenClaw、Hermes Agent、Oh-my-Pi、Pi、Kiro、Antigravity、Trae 及任何支持 MCP 的代理。记忆存储在 Git 项目内，而非单个聊天或工具中，可跨会话、IDE 和终端共享。它提供观察记忆、推理记忆、Git 记忆、代码记忆、长期记忆、紧凑连续性、自动记忆、编排等功能，并附带终端代理 memcode。
工具能力
memorix_session_start
启动或绑定一个会话到指定项目根目录。
memorix_project_context
获取当前项目的上下文摘要，包括相关记忆、文件和警告。
memorix_search
在项目或全局范围内搜索记忆条目。
memorix_detail
获取特定记忆条目的完整详情。
memorix_store
存储新的事实、修复、陷阱或笔记到记忆中。
memorix_resolve
将引用解析为实际的文件、符号或记忆条目。
memorix_media
管理受控媒体资源，如导入、附加、查看和列表。
memorix_checkpoint
查看和管理本机上下文压缩检查点。
memorix_long_term_memory
管理经过审查的长期记忆，包括候选、批准和归档。
memorix_reasoning
搜索和存储设计决策、理由和权衡。
memorix_git_memory
从 Git 提交中提取和存储工程事实。
memorix_code_memory
获取代码状态和符号信息，帮助智能体理解代码库。
memorix_context
构建一个紧凑的任务上下文简报（Memory Autopilot）。
memorix_resume
恢复上一个会话，加载相关摘要和锚点。
memorix_skills
列出或获取可复用的项目技能。
memorix_promote
将持久知识提升为项目技能。
memorix_team
管理团队协作，如任务分配和交接。
memorix_lock
管理文件锁以防止并发冲突。
memorix_task
创建和管理任务用于编排。
memorix_workbench
打开交互式终端记忆控制台。
安装接入
- 安装 Node.js >= 22.18.0 并确保 Git 可用。
- 全局安装 Memorix：
npm install -g memorix。 - 初始化配置（可选）：
memorix init --global。 - 为你的代理设置集成：
memorix setup --agent <agent> --global，例如--agent claude、--agent codex、--agent cursor。 - 如需手动配置 MCP，在客户端添加 stdio 配置：
{"mcpServers":{"memorix":{"command":"memorix","args":["serve"]}}}。 - 可选：启动后台 HTTP 服务：
memorix background start，然后指向http://localhost:3211/mcp。
claude_desktop_config.json
{
"mcpServers": {
"memorix": {
"command": "memorix",
"args": [
"serve"
]
}
}
}
选型与风险
不适合谁
- 只需要单次会话记忆的简单项目。
- 没有 Node.js 或 Git 环境的用户。
- 需要云端同步或集中式记忆管理的团队（Memorix 是本地优先）。
- 需要完全自动、无需审查的长期记忆（长期记忆需手动候选和批准）。
- 对配置敏感的初学者，因为设置涉及多个步骤。
所需权限
- 读取和写入本地文件（项目根目录下的.git和memorix数据目录）。
- 执行 Git 命令（如提交历史读取）。
- 启动本地 HTTP 服务（若启用后台模式）。
- 可选的 API 密钥用于 LLM 生成和嵌入（如 OpenAI、OpenRouter）。
- 安装代理插件、规则、钩子和技能（通过setup命令）。
风险与副作用
- 本地优先意味着记忆不在云端同步，需自行备份。
- 错误配置的 API 密钥可能导致数据发送到第三方，请确保密钥安全。
- 钩子可能消耗计算资源或影响性能。
- 长期记忆需要人工审查，否则可能累积错误信息。
- 编排功能可能创建多个工作树或分支，需注意合并冲突。
常见排障
- 如果 MCP 连接失败，检查 `memorix doctor agents --agent <agent>` 并运行 `memorix repair agents --agent <agent>`。
- 确保 Node.js 版本 >= 22.18.0。
- 确认命令行可以运行 `memorix serve`，无错误输出。
- 确保项目是 Git 仓库，因为记忆绑定到 Git 根目录。
- 如果 HTTP 模式连接失败，检查端口 3211 是否监听：`curl http://localhost:3211/health`。
- 查看日志或运行 `memorix workbench` 诊断。
使用场景
在多个代理会话之间共享项目知识，避免重复解释。
跨 IDE 或终端保持一致的记忆，支持切换工具。
将 Git 提交转化为可搜索的工程事实，快速定位变更影响。
保存架构决策的理由和权衡，供未来会话参考。
管理多代理并行工作，通过编排协调任务、锁和审查。
支持客户端
Claude Code完整支持
Codex CLI完整支持
Cursor完整支持
Windsurf完整支持
Gemini CLI完整支持
GitHub Copilot CLI完整支持
Antigravity完整支持
OpenClaw完整支持
Hermes Agent完整支持
Oh-my-Pi完整支持
Pi完整支持
Kiro完整支持
OpenCode完整支持
Trae完整支持
Any MCP Client完整支持