---

关于作者

• 深耕领域：大语言模型开发 / RAG 知识库 / AI Agent 落地 / 模型微调
• 技术栈：Python | RAG (LangChain / Dify + Milvus) | FastAPI + Docker
• 工程能力：专注模型工程化部署、知识库构建与优化，擅长全流程解决方案

「让 AI 交互更智能，让技术落地更高效」
欢迎技术探讨与项目合作，解锁大模型与智能交互的无限可能！

---

Memorix：跨 Agent 记忆桥梁——让 AI 永不遗忘

摘要

你是否经历过这样的痛苦：每次开启新的对话，AI 助手就忘记了之前讨论的所有内容；从 Cursor 切换到 Claude Code，所有上下文瞬间消失；新团队成员的 AI 从零开始，需要重新解释整个项目架构。Memorix 通过 MCP 协议为 AI 编程助手提供持久化记忆能力，支持 Cursor、Windsurf、Claude Code、Codex、Copilot、Kiro 等 8 大主流平台，彻底解决 AI 记忆丢失问题。本文将从使用者视角深入介绍 Memorix 的核心功能、安装配置和实际应用场景。

---

痛点：AI 助手的记忆困境

典型场景

问题本质

场景	传统方式	后果
新对话	上下文丢失	重新解释项目
切换 IDE	配置不互通	从零开始
团队协作	记忆孤立	每人重复工作
长对话	上下文爆炸	需要重启

---

Memorix 解决方案

核心理念

一个 MCP 服务器，八个 AI 平台，零记忆丢失。

Memorix 通过 MCP (Model Context Protocol) 协议为 AI 编程助手提供：

1. 持久化记忆：跨会话保存项目上下文
2. 跨平台同步：在不同 IDE 间无缝切换
3. 团队共享：新成员的 AI 立即了解项目
4. 智能压缩：长对话自动总结，避免上下文爆炸

架构设计

工作流程

---

30 秒快速开始

安装流程

步骤一：全局安装

npm install -g memorix

重要：不要使用 npx！npx 每次都会下载包，会导致 MCP 服务器初始化超时（60秒限制）。全局安装可以即时启动。

步骤二：配置 MCP

Claude Code

claude mcp add memorix -- memorix serve

或手动添加到 ~/.claude.json：

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

Cursor

在项目根目录创建 .cursor/mcp.json：

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

Windsurf

添加到 ~/.codeium/windsurf/mcp_config.json：

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

步骤三：重启 AI 助手

完成！无需 API 密钥，无需云账户，无依赖。

---

核心功能详解

功能全景

1. 跨会话记忆

会话 1（周一）：
你："项目使用 Next.js + Prisma + tRPC"
Memorix：✓ 已保存项目架构信息

会话 2（周三）：
你："继续开发用户模块"
AI："好的，根据之前的记录，我们使用 Next.js + Prisma + tRPC 架构..."

2. 跨平台同步

3. 团队知识共享

团队成员 A 在 Cursor 中：
"API 响应格式统一使用 { success, data, error }"

团队成员 B 的 Claude Code：
"根据团队规范，API 响应格式为 { success, data, error }"

4. 智能上下文压缩

当对话过长时，Memorix 自动总结关键信息：

原始对话（50 轮）：[详细讨论过程...]

压缩后记忆：
- 技术栈：Next.js 14, Prisma, tRPC
- 认证：JWT + 刷新令牌
- 数据库：PostgreSQL
- 待办：完成支付模块

---

实际应用场景

场景一：长期项目开发

第一周：
你："初始化项目，使用 T3 Stack"
Memorix：记录技术选型决策

第二周：
你："添加用户认证"
Memorix：关联到技术栈，记录认证方案

第三周：
你："继续开发"
AI："根据记录，我们使用 T3 Stack，已完成用户认证，接下来可以..."

场景二：多 IDE 工作流

上午 - Cursor：
"实现前端组件"
Memorix：保存组件设计

下午 - Claude Code：
"继续后端开发"
AI："根据前端组件设计，API 需要提供..."

场景三：团队协作

资深开发者：
"项目架构是微服务，使用 gRPC 通信"
Memorix：保存架构决策

新成员的 AI：
"根据团队记录，项目采用微服务架构..."

---

高级配置

项目根目录设置

某些 IDE（如 Antigravity）使用自己的安装路径作为工作目录，需要显式指定：

{
  "mcpServers": {
    "memorix": {
      "command": "memorix",
      "args": ["serve"],
      "env": {
        "MEMORIX_PROJECT_ROOT": "E:/your/project/path"
      }
    }
  }
}

验证安装

memorix --version       # 检查版本
memorix serve --cwd .   # 测试启动

---

故障排除指南

诊断流程

常见问题诊断

症状	原因	解决方案
memorix · ✗ failed	IDE 找不到命令	运行 npm install -g memorix，Windows 需重启 IDE
初始化超时	使用了 npx	改用全局安装，配置改为 "command": "memorix"
反复重连后失败	进程崩溃	检查 Node.js ≥ 18，确保打开真实项目目录
无有效项目检测	工作目录是系统目录	设置 MEMORIX_PROJECT_ROOT 环境变量
命令未找到	npm 全局 bin 不在 PATH	添加 npm bin 到系统 PATH，重启 IDE
终端可用但 IDE 不可用	PATH 不一致	Windows 重启 IDE，Linux/Mac 检查 shell 配置

正确配置示例

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

错误配置（请避免）

---

与其他方案对比

特性	Memorix	手动文档	云端同步
零配置	✅	❌	❌
跨平台	✅ 8+ 平台	❌	✅ 有限
本地优先	✅	✅	❌
自动记忆	✅	❌	❌
团队共享	✅	❌	✅
无需付费	✅	✅	❌

---

支持的 AI 平台

平台	配置文件	特殊说明
Claude Code	~/.claude.json	支持 CLI 安装
Cursor	.cursor/mcp.json	项目级配置
Windsurf	~/.codeium/windsurf/mcp_config.json	-
VS Code Copilot	MCP 配置	-
Codex	MCP 配置	-
Kiro	MCP 配置	-
Gemini CLI	.gemini/settings.json	-
Antigravity	MCP 配置	需设置 MEMORIX_PROJECT_ROOT

---

最佳实践

记忆分类策略

1. 记忆分类

让 AI 按类别保存信息：

"记住这个技术决策：[架构决策] 使用 PostgreSQL 作为主数据库"
"记住这个约定：[代码规范] API 路由统一使用 kebab-case"
"记住这个问题：[待办] 需要优化首页加载速度"

2. 定期总结

"总结一下目前的项目进度和待办事项"
Memorix 会保存总结，方便后续回顾

3. 团队规范

将团队约定保存到项目记忆：

"记住团队规范：
- Git 分支：feature/xxx, fix/xxx
- 代码风格：ESLint + Prettier
- 提交格式：conventional commits"

---

总结

Memorix 是解决 AI 编程助手记忆丢失问题的完美方案。它通过 MCP 协议实现了：

• 持久化记忆：不再需要重复解释项目
• 跨平台同步：在任意 IDE 间无缝切换
• 团队协作：知识共享，避免重复工作
• 零成本使用：无需 API 密钥，无需云账户

如果你正在使用多个 AI 编程助手，或者厌倦了每次新对话都要重新解释项目，Memorix 绝对是你的必备工具。30 秒安装，终身受益。

---

相关链接：

• GitHub：https://github.com/AVIDS2/memorix
• 文档：https://github.com/AVIDS2/memorix/blob/main/README.md
• 完整设置指南：https://github.com/AVIDS2/memorix/blob/main/docs/SETUP.md