Skip to main content
Glama
stflj2022

mcp-memvid

by stflj2022

MCP-Memvid with LCM

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

✨ 特性

LCM (Lossless Context Management)

  • 自动压缩: 对话超过阈值时自动摘要旧消息

  • 完全集成: 所有数据存储在单个 Memvid .mv2 文件中

  • 持久化: 消息、摘要、记忆都在 Memvid 中,不会丢失

  • 智能搜索: 统一搜索所有历史对话和记忆

长期记忆

  • 跨会话记忆: 在不同 Claude Code 窗口间共享记忆

  • 语义搜索: 使用自然语言查找相关记忆

  • 分类管理: 按项目、偏好、决策、模式等分类存储

基于 LCM 论文lossless-claw 项目。

Related MCP server: claude-recall

🚀 快速安装

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

⚙️ 配置

将以下内容添加到 ~/.claude.jsonmcpServers 部分:

{
  "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

F
license - not found
-
quality - not tested
D
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/stflj2022/mcp-memvid'

If you have feedback or need assistance with the MCP directory API, please join our Discord server