← 返回目录

Memorix

社区

面向 AI 编码代理的本地优先共享记忆层。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 开发工具第 38 / 438
Stars: ★ 832 非常热门
传输方式: stdio（本地进程） · Streamable HTTP
运行环境: Node.js >=22.18.0 · Docker
凭据: 可选 API Key
许可证: Apache-2.0
最近提交: 3 天前
工具数: 20

66FMRS · C

Memorix 是一个功能丰富的本地优先 MCP 服务器，专为 AI 编码代理设计。它支持广泛的代理和客户端，提供多种记忆类型和工具，适合需要跨会话持久记忆的团队。安装和配置相对复杂，但文档详尽。非官方维护，但开源社区活跃。

最强项 · 文档质量 16/20 最弱项 · 可靠性 8/20

可靠性

8/20

安全与权限

15/20

维护活跃度

14/20

文档质量

16/20

安装易用性

13/20

查看各项评分依据

可靠性 8/20: 可信证据仅来自清单与 README 的自述一致性：npm 包 memorix 1.4.1、stdio 的 serve 参数、Node >=22.18.0、项目身份绑定 Git 根目录、micro 模式 7 个工具、无嵌入服务时关键词回退等。干净启动并完成 init/tools 握手是'可能成立'的，但所给材料中没有源码、已提交测试或 CI 工作流文件，CI 徽章和 npm test 只是 README 声明，server.json 也未列出工具/capabilities 清单可供核对。因此按'快乐路径可行但测试与错误处理薄弱'的锚点评分，且受静态审查上限约束，保守给 8 分。
安全与权限 15/20: 材料中未发现红线问题：配置示例没有真实密钥，无隐蔽外传模式，删除/计费等危险操作均需显式确认（如 uninstall --yes、media generate、MEMORIX_MCP_MEDIA_GENERATION=1）。数据边界较清晰：本地优先的 SQLite/Orama 存储，媒体导入后哈希并保存在 Git 工作区之外，搜索默认项目级隔离，仅 user+portable 的长期记忆项可跨项目，API key 从环境/配置文件读取且媒体库不保存密钥。扣分：多个 Agent 的集成默认安装 hooks 捕获提示词和工具事件（只能 --noHooks 退出而非显式加入），setup 会写入大量 Agent/编辑器配置位置，示例配置默认开启 LLM formation（active），意味着记忆文本可能发送给模型厂商。综合给 15 分。
维护活跃度 14/20: 证据表明项目处于活跃且有版本管理的状态：Apache-2.0 许可证、manifest 与 npm 元数据一致的 1.4.1 版本、Changelog 与文档地图、CI 徽章（未验证）、仓库未归档，README 也长期更新。按规则未使用 610 星或下载量等流行度信号。扣分：所给材料中没有提交历史、发布日期、issue 响应证据、依赖更新节奏或安全响应渠道，无法从证据本身确认长期维护节奏与治理完备性，因此不到满分。给 14 分。
文档质量 16/20: 文档分层且相当详尽：安装命令、各 Agent 集成表说明每种安装会写入什么、记忆模型层级、运行模式矩阵、TOML 配置示例、Docker、SDK 示例、文档地图、llms.txt、Changelog，并坦承多项限制（无嵌入时关键词回退、20 MiB 视觉上限、计费的 MCP 媒体生成默认关闭、Lite 索引诚实声明能力边界）。扣分：真正的 MCP 工具/参数参考只给了 docs/API_REFERENCE.md 链接而未在材料中呈现，manifest 也未列出工具列表可核对 schema，成本说明仅覆盖 MiniMax 与 embedding 通道，故障排查内容多为指向 Playbook 而非直接给出。给 16 分。
安装易用性 13/20: 主流客户端的主路径简短具体：安装 Node >=22.18.0 后 npm install -g memorix，再为各 Agent 执行 memorix setup --agent <agent> --global；另有 5 行 stdio JSON 手动配置示例，以及 HTTP（background start）与 Docker 的明确路径，各 Agent 行为差异和 Windows 专属路径也有说明。扣分并保守处理：所给文件没有可验证的执行证据（静态上限 15 分）；Node 22.18.0+ 前置要求对部分用户偏高；个别目标需要额外人工确认（如 Codex 需在 /hooks 中审查插件钩子）；多个 Agent 默认安装 hooks 使'若干步完成'的普适性下降；各 Agent 安装面差异大，setup 写入位置多。给 13 分。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件写入 / 删除本地文件执行命令或代码访问网络连接数据库

适合谁

需要在不同 AI 编码工具间共享项目记忆的开发团队。
频繁开启新会话并丢失上下文的有经验开发者。
希望保留设计决策和推理过程的项目。
需要本地优先、隐私友好的记忆存储的用户。
使用多种 MCP 兼容代理并希望统一记忆层的用户。

不适合谁

只需要单次会话记忆的简单项目。
没有 Node.js 或 Git 环境的用户。
需要云端同步或集中式记忆管理的团队（Memorix 是本地优先）。
需要完全自动、无需审查的长期记忆（长期记忆需手动候选和批准）。
对配置敏感的初学者，因为设置涉及多个步骤。

所需权限

读取和写入本地文件（项目根目录下的.git和memorix数据目录）。
执行 Git 命令（如提交历史读取）。
启动本地 HTTP 服务（若启用后台模式）。
可选的 API 密钥用于 LLM 生成和嵌入（如 OpenAI、OpenRouter）。
安装代理插件、规则、钩子和技能（通过setup命令）。

风险与副作用

本地优先意味着记忆不在云端同步，需自行备份。
错误配置的 API 密钥可能导致数据发送到第三方，请确保密钥安全。
钩子可能消耗计算资源或影响性能。
长期记忆需要人工审查，否则可能累积错误信息。
编排功能可能创建多个工作树或分支，需注意合并冲突。

安装接入

准备工作

运行环境：Node.js >=22.18.0 · Docker

OPENROUTER_API_KEY 可选密钥 OpenRouter 的 API 密钥，用于语义嵌入检索（可选，不设置则使用关键词检索）。

MEMORIX_EMBEDDING_API_KEY 可选密钥嵌入 API 密钥的显式覆盖项，优先级高于 OPENROUTER_API_KEY（可选）。

MINIMAX_API_KEY 可选密钥 MiniMax 的 API 密钥，用于图像/视频生成（可选，仅在 CLI 显式生成或设置 MEMORIX_MCP_MEDIA_GENERATION=1 时使用）。

MINIMAX_CN_API_KEY 可选密钥 MiniMax 中国区 API 密钥，作用同 MINIMAX_API_KEY（可选）。

其他可选配置项（1 个）

MEMORIX_MCP_MEDIA_GENERATION 可选设为 1 才允许 MCP 工具请求 MiniMax 付费生成，默认禁用（非密钥）。

安装 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。

.mcp.json

{
  "mcpServers": {
    "memorix": {
      "command": "memorix",
      "args": [
        "serve"
      ]
    }
  }
}

以 Claude Code 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "memorix": {
      "command": "memorix",
      "args": [
        "serve"
      ]
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add memorix -- memorix serve

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

运行 npm install -g memorix 并执行 memorix setup --agent claude --global（或手动在客户端配置 command 为 memorix、args 为 ["serve"]），重启客户端后工具列表中应出现 memorix_session_start、memorix_search、memorix_store 等工具；调用 memorix_project_context 能返回当前 Git 项目的记忆简报即证明连接成功。

常见排障

如果 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` 诊断。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

搜索一下项目里关于发布阻塞问题的记忆
存储一条记忆：认证模块决定使用 JWT，因为 API 是无状态的
给我当前任务的上下文简报，方便继续之前的工作
这次提交改了什么，为什么重要？

工具能力 20

memorix_session_start 只读

启动或绑定一个会话到指定项目根目录。

memorix_project_context 只读

获取当前项目的上下文摘要，包括相关记忆、文件和警告。

memorix_search 只读

在项目或全局范围内搜索记忆条目。

memorix_detail 只读

获取特定记忆条目的完整详情。

memorix_store 写入

存储新的事实、修复、陷阱或笔记到记忆中。

memorix_resolve 只读

将引用解析为实际的文件、符号或记忆条目。

memorix_media 写入

管理受控媒体资源，如导入、附加、查看和列表。

memorix_checkpoint 写入

查看和管理本机上下文压缩检查点。

展开其余 12 个工具

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 只读

打开交互式终端记忆控制台。

使用场景

在多个代理会话之间共享项目知识，避免重复解释。

跨 IDE 或终端保持一致的记忆，支持切换工具。

将 Git 提交转化为可搜索的工程事实，快速定位变更影响。

保存架构决策的理由和权衡，供未来会话参考。

管理多代理并行工作，通过编排协调任务、锁和审查。

支持客户端

Claude Code

Codex

Cursor

Windsurf

Gemini CLI

GitHub Copilot CLI

Antigravity

OpenClaw

Hermes Agent

Oh-my-Pi

Kiro

OpenCode

Trae

依据项目文档列出，未经本站实测。

详细介绍

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。