AI导哈

AI记忆存储服务

mcp-backpack是一个为Claude Code设计的持久化、可移植的内存层服务，提供项目范围的数据库存储和Git同步功能，适用于AI代理的上下文记忆和团队协作。

  • by primerpy
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 primerpy/mcp-backpack

使用说明

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.跨机器同步（行驶模式）✈️

从工作电脑转移到个人笔记本电脑？

  1. 工作中： “旅行包。”（创建 backpack.json)
  2. Git： git add backpack.json && git commit -m "sync memory" && git push
  3. 在家： git pull
  4. 克劳德： “打开旅行的包装。”

工具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许可证

相关 MCP