LocalKeep

LocalKeep

LocalKeep 面向所有希望为聊天机器人提供按时间顺序排列的记忆层，并由自己直接控制模型记住自己什么内容的人。你无需依赖围绕你凭空编造、无法编辑的黑箱云端记忆。LocalKeep 让你在自己的设备上整理带标题和日期、可编辑的记忆库，你可以编写条目，并通过本地主机 Hub UI 在本地管理它们。当对话需要你过去的上下文时，Claude 会通过安全的原生 Model Context Protocol (MCP) 连接器查询你的本地数据。

为什么使用 LocalKeep

AI 聊天应用很擅长表现得好像记得你，但很难回忆你关心的确切内容——发生了什么、在哪一天、与谁有关？面向消费者的记忆功能往往缺乏真正进行时间推理的能力，只会把你的经历压缩成模糊、笼统的氛围式摘要，而不是理解事件 A 如何在三个月前引发事件 B。因此，当你需要查询具体内容时，它们的推理就会失效：某个人生事件、一段研究历程，或几个月前记录的一项决定。更糟的是，面向消费者的 AI 记忆是个黑箱：你无法决定模型选择记住关于你的什么内容、如何解读你的人生，或何时围绕你编造上下文。

LocalKeep 一举解决了这两个结构性缺陷：它用严谨、按时间顺序排列的、属于你自己的事实记录，取代脆弱且由模型编造的时间线，同时让你拥有完全的编辑控制权。你可以准确决定 AI 能了解关于你的哪些内容。你编写条目、标注日期，并将它们保存在自己的设备上。对话需要你过去的上下文时，Claude 只会通过 MCP 充当查询引擎。 LocalKeep 架起了个人结构化记录与智能 AI 检索之间的桥梁，确保你的上下文由你整理，而不是由大模型幻觉生成。

适用人群

• 对聊天记忆无法可靠查找带日期的事实或理解时间线感到失望的人
• 已经认真维护个人日记、工作日志或研究档案的人。你无需再满足于聊天应用生成的泛泛转述，而是可以将自己的原话和历史数据注入提示词，作为不可动摇的事实来源。
• 信任 Claude 的推理能力，但要求自己的基础上下文数据库存储在本地、由自己掌控的用户。（注意：通过 MCP 查询记忆时，仍会在会话期间将检索到的文本片段发送给 Anthropic。）

它是什么（以及不是什么）

• **是：**一款轻量、可自定义的本地 Hub UI，用于管理带日期的记忆库，并配有 Claude Desktop 可调用的 MCP 服务。
• **不是：**独立聊天应用、云托管记忆 API，或会悄悄抓取个人对话的后台工具。

美学理念

Hub UI 有意采用复古的 Windows 95 / MS Paint 风格致敬设计，并提供可自定义功能，让 LocalKeep 更像是个人专属工具，而不是冷冰冰、僵化的仪表盘。通过让你随手就能调整界面元素，UI 表明你正进入一个私密、离线的思维工作室——一个你可以随心塑造和重新配置、完全属于自己的空间。

安装

pip install localkeep
# or: uv tool install localkeep

然后：

localkeep-hub          # http://127.0.0.1:8000

在 Claude Desktop 中注册 MCP 服务（claude_desktop_config.json）：

{
  "mcpServers": {
    "localkeep": {
      "command": "localkeep-mcp",
      "args": []
    }
  }
}

如果 GUI 无法在你的 PATH 中找到 localkeep-mcp，请使用 which localkeep-mcp 返回的绝对路径（Hub 的 Connect 面板会为你复制该路径）。

通过 pip 安装时，记忆默认存储在 ~/.localkeep/localkeep.db。使用 LOCALKEEP_DATA_DIR 或 LOCALKEEP_DB_PATH 可覆盖此设置。

自动使用 LocalKeep（重要）

Claude 不一定会可靠地调用 MCP 工具，因此还需要设置个人偏好设置：

1. Claude Desktop → 设置 → 个人资料 → 个人偏好设置
2. 粘贴 LocalKeep 指令（Hub → 连接 → 复制指令，或参见 src/localkeep/assets/claude-personal-preferences.txt）
3. 完全退出 Claude，然后重新打开
4. LocalKeep 询问是否运行工具时，点击始终批准

从源代码开发

git clone https://github.com/zuneracodes/localkeep
cd localkeep
uv sync --group dev
uv run localkeep-hub                     # http://127.0.0.1:8000
# optional live reload:
LOCALKEEP_HUB_RELOAD=1 uv run localkeep-hub

从源代码检出时，数据库位于 data/localkeep.db（已加入 gitignore）。

测试

这些测试会对 Hub、检索功能和 MCP 工具进行冒烟测试，确保全新安装后仍能像真实用户那样存储和回忆带日期的记忆。

uv sync --group dev
uv run pytest

测试从空数据库开始，并通过 Hub 表单 POST 创建记忆（与新用户使用的路径相同）。

隐私

数据存储在本地。 知识库和记忆保存在你选择的数据库路径中（pip 安装使用 ~/.localkeep/，检出代码时使用 data/localkeep.db）。LocalKeep 没有云端服务，也不会自动抓取聊天内容。主题颜色保存在浏览器的 localStorage 中。刷新 Hub 页面或重启 localkeep-hub 不会删除你的知识库——只有移除数据库文件才会删除。

回忆通过 Claude 完成。 Hub 和数据库保留在你的设备上，但当 Claude 调用 LocalKeep MCP 工具时，匹配的记忆会返回到该聊天中，Anthropic 会像处理其他工具结果一样处理这些内容。LocalKeep 不会将整个数据库上传——只会返回针对当前问题的查询结果。

贡献

欢迎通过 GitHub Issues 提交 Bug 报告和拉取请求。请在提交 PR 前运行 uv run pytest。

许可证

MIT — 参见 LICENSE。