MemPalace — 本地 AI 记忆系统

您可通过 MCP 工具访问一个运行在本地的“记忆宫殿”。该宫殿完整存储原始对话历史及一个带时间维度的知识图谱——全部数据均保存在用户本地机器上，不涉及任何云端服务，也不发起任何 API 调用。

架构

• 翼（Wings） = 人物或项目（例如：wing_alice、wing_myproject）
• 厅（Halls） = 分类（如：事实、事件、偏好、建议）
• 室（Rooms） = 具体主题（例如：chromadb-setup、riley-school）
• 抽屉（Drawers） = 单条记忆片段（原始文本）
• 知识图谱（Knowledge Graph） = 带时间有效性的实体-关系事实

协议 — 每次会话请严格遵守

1. 唤醒时（ON WAKE-UP）：调用 mempalace_status 加载宫殿概览。
2. 回应前（BEFORE RESPONDING）：凡涉及任何人、任何项目或过往事件，必须先调用 mempalace_search 或 mempalace_kg_query 查询；严禁凭记忆猜测——一切以宫殿为准。
3. 存疑时（IF UNSURE）：若对某项事实（姓名、年龄、关系、偏好等）不确定，请明确表示“让我查一下”，并立即查询。出错比响应稍慢更不可接受。
4. 每轮会话结束后（AFTER EACH SESSION）：调用 mempalace_diary_write 记录本次会话发生了什么、你学到了什么、哪些内容值得记住。
5. 事实变更时（WHEN FACTS CHANGE）：先调用 mempalace_kg_invalidate 使旧事实失效，再调用 mempalace_kg_add 添加新事实。

可用工具

搜索与浏览

• mempalace_search — 全量记忆语义搜索。始终从此处开始。
  • query（必需）：自然语言查询语句
  • wing：按翼过滤
  • room：按室过滤
  • limit：最大返回结果数（默认为 5）
• mempalace_status — 宫殿概览：抽屉总数、翼数、室数
• mempalace_list_wings — 列出所有翼及其抽屉数量
• mempalace_list_rooms — 列出某翼下的所有室
• mempalace_get_taxonomy — 输出完整的翼/室/数量树状结构

知识图谱（带时间维度的事实）

• mempalace_kg_query — 查询实体间关系，支持按时间过滤。
  • entity（必需）：例如 “Max”、“MyProject”
  • as_of：日期过滤器（YYYY-MM-DD）——查询该时间点成立的事实
  • direction：“outgoing”、“incoming” 或 “both”
• mempalace_kg_add — 添加一条事实：主语 → 谓语 → 宾语
  • subject、predicate、object（必需）
  • valid_from：该事实开始成立的时间
• mempalace_kg_invalidate — 将某条事实标记为不再成立
  • subject、predicate、object（必需）
  • ended：该事实终止的时间（默认为今日）
• mempalace_kg_timeline — 某实体按时间顺序排列的完整事实演进史
• mempalace_kg_stats — 图谱概览：实体数、三元组数、关系类型数

宫殿图谱（跨域连接）

• mempalace_traverse — 从指定室出发，遍历跨翼关联概念
  • start_room（必需）：起始室名
  • max_hops：连接深度（默认为 2）
• mempalace_find_tunnels — 查找同时连接两个翼的室
• mempalace_graph_stats — 图谱连通性概览

写入操作

• mempalace_add_drawer — 将原始内容存入指定翼/室
  • wing、room、content（必需）
  • 自动去重
• mempalace_delete_drawer — 根据 ID 删除指定抽屉
• mempalace_diary_write — 写入会话日记条目
  • agent_name（必需）：你的名称
  • entry（必需）：发生了什么、你学到了什么
  • topic：分类标签
• mempalace_diary_read — 读取最近的日记条目

初始化设置

用户需首先完成宫殿初始化与数据填充：

pip install mempalace
mempalace init ~/my-convos
mempalace mine ~/my-convos

随后通过 MCP 接入（适用于 Claude Code、Cursor 等）：

claude mcp add mempalace -- python -m mempalace.mcp_server

对于 OpenClaw，请将其添加至你的 MCP 配置文件中：

{
  "mcpServers": {
    "mempalace": {
      "command": "python3",
      "args": ["-m", "mempalace.mcp_server"]
    }
  }
}

使用提示

• 搜索基于语义（含义），而非关键词匹配。“我们之前讨论过数据库性能吗？”比仅输入“database”效果更好。
• 知识图谱存储的是带类型和时间窗口的关系。请将它用于记录人物与项目相关的事实——它能精确回答“某事何时为真”。
• 日记条目会在各次会话中持续累积。每次对话结束时都应撰写一条日记，以建立长期上下文连贯性。
• 挖掘（mine）阶段会自动根据目录名识别翼。你也可通过 mempalace_add_drawer 手动创建自定义翼。

许可证与署名

本能力是 MemPalace 的集成模块，由 Ben Sigman（@bensig）、Igor Lins e Silva（@igorls）、Milla Jovovich（@milla-jovovich）与 adv3nt3（@adv3nt3）共同开发，采用 MIT 许可证授权。

MIT License

Copyright (c) 2026 MemPalace Contributors

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.