Memvid

MCP Server for Memvid - 给 Claude Code 提供长期记忆和无损上下文管理功能。

✨ 特性

LCM (Lossless Context Management)

• 自动压缩: 对话超过阈值时自动摘要旧消息
• 完全集成: 所有数据存储在单个 Memvid .mv2 文件中
• 持久化: 消息、摘要、记忆都在 Memvid 中，不会丢失
• 智能搜索: 统一搜索所有历史对话和记忆

长期记忆

• 跨会话记忆: 在不同 Claude Code 窗口间共享记忆
• 语义搜索: 使用自然语言查找相关记忆
• 分类管理: 按项目、偏好、决策、模式等分类存储

基于 LCM 论文 和 lossless-claw 项目。

🚀 快速安装

git clone https://github.com/stflj2022/mcp-memvid.git
cd mcp-memvid
npm install
npm run build
chmod +x install.sh
./install.sh

⚙️ 配置

将以下内容添加到 ~/.claude.json 的 mcpServers 部分：

{
  "mcpServers": {
    "memvid": {
      "type": "stdio",
      "command": "node",
      "args": ["$HOME/.claude/mcp-memvid/dist/index.js"]
    }
  }
}

🛠️ 工具

LCM 工具

工具	描述
lcm_status	查看上下文状态和压缩建议
lcm_compact	执行上下文压缩
lcm_list_summaries	列出所有摘要
lcm_search	在消息和摘要中搜索

记忆工具

工具	描述
memvid_auto_resume	自动恢复上次中断的对话
memvid_save_context	保存当前对话上下文
memvid_store	存储长期记忆
memvid_search	搜索长期记忆
memvid_summary	获取记忆摘要

📖 使用示例

查看上下文状态

lcm_status()

输出：

📊 LCM 状态

📝 当前消息: 150 条
🔤 估算 tokens: 180,000
📦 已创建摘要: 3 个
🎯 压缩阈值: 150,000 (75%)

⚠️  建议执行压缩
   可压缩约 86 条消息
   运行: lcm_compact()

执行压缩

lcm_compact()

搜索历史

lcm_search(query="dice-memonic bug")

自动恢复（中断后继续）

memvid_auto_resume()

存储长期记忆

memvid_store(content="用户偏好简洁回答", category="preference", importance=7)

💡 数据架构

┌─────────────────────────────────────────┐
│         ~/.claude-memories/             │
│                                         │
│  ┌───────────────────────────────────┐  │
│  │     claude-memories.mv2           │  │
│  │     (Memvid Database)             │  │
│  │                                   │  │
│  │  ┌─────────────────────────────┐  │  │
│  │  │  Messages (type:message)    │  │  │
│  │  │  - role, content, timestamp │  │  │
│  │  │  - compressed flag          │  │  │
│  │  └─────────────────────────────┘  │  │
│  │                                   │  │
│  │  ┌─────────────────────────────┐  │  │
│  │  │  Summaries (type:summary)  │  │  │
│  │  │  - content, sourceIds       │  │  │
│  │  │  - depth, topics            │  │  │
│  │  └─────────────────────────────┘  │  │
│  │                                   │  │
│  │  ┌─────────────────────────────┐  │  │
│  │  │  Memories (type:memory)    │  │  │
│  │  │  - content, category        │  │  │
│  │  │  - tags, importance         │  │  │
│  │  └─────────────────────────────┘  │  │
│  │                                   │  │
│  │  ┌─────────────────────────────┐  │  │
│  │  │  Context Snapshots          │  │  │
│  │  └─────────────────────────────┘  │  │
│  │                                   │  │
│  └───────────────────────────────────┘  │
│                                         │
│  context-cache.json (仅用于快速启动缓存)  │
└─────────────────────────────────────────┘

🎯 解决的问题

问题	解决方案
上下文超限中断	LCM 自动压缩，延长单次会话
中断后无法继续	memvid_auto_resume() 恢复上下文
旧对话丢失	所有内容保存在 Memvid，可搜索
跨会话记忆	Memvid 长期存储 + 语义搜索
数据分散	单一 .mv2 文件存储所有数据

📂 数据位置

~/.claude-memories/
├── claude-memories.mv2      # 所有数据（消息、摘要、记忆）
└── context-cache.json       # 启动缓存（可删除，会重建）

📄 License

MIT