mcp背包🎒
Claude Code的持久、可移植存储层。
网站: mcpbackpack.com
mcp-backpack 为您的AI代理提供了一个“硬盘”。它在您的工作目录中创建了一个项目范围的数据库,即使在您清除上下文窗口或重新启动终端后,Claude也能记住上下文、架构决策和待办事项列表。
与其他存储工具不同, 背包是为旅行而设计的。 您可以将内存“打包”到JSON文件中,将其提交到Git,然后在另一台机器上“解包”。
特性
- 💾 持久上下文: 将一般想法、摘要和状态保存到本地SQLite数据库(
.backpack_memory). - 📂 项目范围: 自动检测您正在处理的项目,并为其创建单独的内存仓。
- ✈️ Git同步: 将数据库导出到
backpack.json与团队共享上下文或在工作笔记本电脑和家用电脑之间同步。 - ⚡ 零配置: 建立在
diskcache和mcp无需运行服务器或Docker容器。
安装
选项1:通过PyPI安装(推荐)
您可以使用以下命令将此工具直接添加到Claude Code中 uvx.
claude mcp add backpack -- uvx mcp-backpack方案2:从源头上运行(当地发展)
如果您已克隆此存储库并希望在本地运行它:
# Assuming you are in the repo root
claude mcp add backpack -- uvx --from . mcp-backpack配置
为了防止将本地二进制数据库提交到Git, 您必须更新您的 .gitignore.
在项目根目录中运行此命令:
echo ".backpack_memory/" >> .gitignore注: 不要忽视 backpack.json 如果你打算使用同步功能!用法
安装后,只需与Claude交谈即可。该工具提供以下功能:
1.日常工作流程
- 省省一点心思: “将当前API架构作为
schema:auth." - 找回一个想法: “检查背包
schema:auth." - 搜索: “在背包里翻找任何与‘数据库’有关的东西。”
- 列出全部: “列出背包里的东西。”
2.“上下文压缩”协议
当Claude的上下文窗口填满时,在清除之前使用背包保存您的状态:
“在压缩上下文之前,请保存我们当前的task:next_steps和session:summary到背包。"
3.跨机器同步(行驶模式)✈️
从工作电脑转移到个人笔记本电脑?
- 工作中: “旅行包。”(创建
backpack.json) - Git:
git add backpack.json && git commit -m "sync memory" && git push - 在家:
git pull - 克劳德: “打开旅行的包装。”
工具API
服务器向LLM公开以下工具:
| 工具 | 说明 |
|---|---|
put_in_backpack | 将键值对保存到本地 .backpack_memory 数据库。 |
check_backpack | 按键检索特定值。 |
rummage_backpack | 模糊搜索包含特定字符串的键和值 |
list_contents | 列出当前存储在项目背包中的所有密钥。 |
toss_out | 从内存中永久删除密钥。 |
pack_for_travel | 将二进制数据库导出为人类可读 backpack.json. |
unpack_from_travel | 进口 backpack.json 进入活动记忆。 |
许可证
MIT许可证
