/ 目录 / 演练场 / Memorix
● 社区 AVIDS2 ⚡ 即开即用

Memorix

作者 AVIDS2 · AVIDS2/memorix

一个记忆库,多个编程 agent 共享——上下文在 Claude Code、Cursor、Codex、Windsurf 之间随你切换,不再每天重复说「我们用 pnpm 和 tsx」。

Memorix 是一个小型 MCP 服务器,提供仅追加的结构化记忆存储,并向所有支持 MCP 的编程 agent 暴露该存储。添加一次事实(例如「auth 在 /apps/api/src/auth,不要用废弃的 /legacy/auth」),任何连接的 agent 都可以读取。设计上不绑定特定工具——默认使用本地文件后端,可选云端同步。

为什么要用

核心特性

实时演示

实际使用效果

memorix-mcp.replay ▶ 就绪
0/0

安装

选择你的客户端

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "memorix-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "memorix"
      ]
    }
  }
}

打开 Claude Desktop → Settings → Developer → Edit Config。保存后重启应用。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "memorix-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "memorix"
      ]
    }
  }
}

Cursor 使用与 Claude Desktop 相同的 mcpServers 格式。项目级配置优先于全局。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "memorix-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "memorix"
      ]
    }
  }
}

点击 Cline 侧栏中的 MCP Servers 图标,然后选 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "memorix-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "memorix"
      ]
    }
  }
}

格式与 Claude Desktop 相同。重启 Windsurf 生效。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "memorix-mcp",
      "command": "npx",
      "args": [
        "-y",
        "memorix"
      ]
    }
  ]
}

Continue 使用服务器对象数组,而非映射。

~/.config/zed/settings.json
{
  "context_servers": {
    "memorix-mcp": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "memorix"
        ]
      }
    }
  }
}

加入 context_servers。Zed 保存后热重载。

claude mcp add memorix-mcp -- npx -y memorix

一行命令搞定。用 claude mcp list 验证,claude mcp remove 卸载。

使用场景

实战用法: Memorix

跨所有编程 agent 共享项目约定,无需重复说明

👤 同时使用多个 AI 编程工具的开发者 ⏱ ~15 min beginner

何时使用: 你在第一天向 Cursor、Claude Code 和 Codex 分别解释了相同的 monorepo 结构,却记不清哪个知道什么。

前置条件
  • Memorix 正在运行npx memorix——默认使用 ~/.memorix.db
步骤
  1. 录入记忆
    Save these facts about my project: package manager pnpm, runtime node 22, db postgres 16, auth in /apps/api/src/auth (not /legacy/auth).✓ 已复制
    → 5 条记忆已追加,并带有标签
  2. 在其他 agent 中召回
    (在配置了相同 Memorix 的 Cursor 中)— What conventions are set for this project?✓ 已复制
    → 返回相同的 5 条记忆
  3. 更新一条
    Update memory: now using node 24 (was 22). Keep history.✓ 已复制
    → 已更新;历史记录以版本形式保留

结果: 项目上下文跨 agent 和跨天持久存在。

注意事项
  • 记忆变得过时 — 使用 decay 将旧记忆标记为低置信度;agent 会相应降低其权重

将架构决策记录为可查询的记忆

👤 技术负责人、Staff 工程师 ⏱ ~20 min intermediate

何时使用: 你做了一个决定(「我们不用 Redux,只用 zustand」),希望它能长期生效。

步骤
  1. 记录决策
    Save decision: 'Use zustand, not Redux. Reason: simpler API, smaller bundle.' Tag: state-management.✓ 已复制
    → 决策已保存,带标签
  2. 验证落实
    Whenever Claude is about to import redux in this repo, reject and quote the decision.✓ 已复制
    → 后续导入会被标记,并引用已保存的原因

结果: 一份轻量级的 ADR 日志,agent 会真正读取。

注意事项
  • Memorix 是单用户的;团队级 ADR 需要云端同步或提交到代码库的镜像 — 使用 --export ./adr.json 并提交;队友 --import 同步
搭配使用: github

将调试会话移交给另一个 agent

👤 在任务中途切换模型的开发者 ⏱ ~10 min intermediate

何时使用: Claude 已经调试了 2 小时,你想切换到 Codex,但不想重新解释所有内容。

步骤
  1. 快照
    Snapshot current debugging context: hypothesis, what we ruled out, next step.✓ 已复制
    → 快照已保存,标签为 debug-session-<id>
  2. 在其他 agent 中接续
    (在 Codex 中)— Load debug session and continue from where Claude left off.✓ 已复制
    → Codex 总结快照并提出下一步

结果: 任务中途无痛切换 agent。

注意事项
  • 快照太模糊,新 agent 从头开始 — Memorix 的快照工具会提示你填写:假设、证据、下一步——三项都要填

组合

与其他 MCP 搭配,撬动十倍杠杆

memorix-mcp + github

将记忆镜像到已提交的 adr.json 文件供团队共享

Export memories tagged 'adr' to /docs/adr.json and commit.✓ 已复制
memorix-mcp + filesystem

备份本地 Memorix 数据库

Copy ~/.memorix.db to /backups/$(date +%F)/.✓ 已复制

工具

此 MCP 暴露的能力

工具输入参数何时调用成本
save content: str, tags: str[] 持久化一条事实、决策或快照 免费
recall query?, tags?, limit? 将相关上下文引入当前任务 免费
update id, content 纠正或完善已有记忆 免费
decay older_than_days 定期清理 免费

成本与限制

运行它的成本

API 配额
本地 SQLite——受磁盘空间限制
每次调用 Token 数
每次召回 100–500 token
费用
免费;云端同步(如使用)费用各异
提示
每周运行一次 decay,让召回查询返回紧凑的最新上下文,而不是 6 个月前的调试笔记

安全

权限、密钥、影响范围

凭据存储: 默认本地 SQLite;云端同步需要 API key
数据出站: 默认仅限本地

故障排查

常见错误与修复

召回结果不相关

检查标签是否匹配——Memorix 同时使用标签过滤和模糊文本搜索

验证: 不带过滤条件运行,查看所有记忆
DB 锁定错误

多个 agent 同时写入——Memorix 使用 WAL 模式;请确保版本 >= 0.4

导入失败

导出版本和导入版本之间 schema 不匹配——请先升级两端

替代方案

Memorix 对比其他方案

替代方案何时用它替代权衡
doobidoo/mcp-memory-service你想要知识图谱和记忆整合等更丰富的功能功能更重;Memorix 刻意保持极简
OpenAI Memory / Anthropic Memory你只使用一家提供商绑定该提供商;Memorix 跨 agent 通用

更多

资源

📖 阅读 GitHub 上的官方 README

🐙 查看未解决的 issue

🔍 浏览全部 400+ MCP 服务器和 Skills