tool-notes/mempalace-notes.md

MemPalace 安裝與使用筆記

基本資訊

• 專案: https://github.com/MemPalace/mempalace
• 版本: 3.3.0
• 授權: MIT
• 需求: Python 3.9+
• 安裝日期: 2026-04-15

安裝

pip install mempalace

主要相依套件：ChromaDB（向量資料庫）、PyYAML、ONNX Runtime。

核心概念

MemPalace 用階層式結構組織記憶：

• Wing（翼）— 對應一個專案或一個人
• Room（房間）— 對應一個主題
• Drawer（抽屜）— 原始內容（不做摘要，保留完整原文）

所有資料存在本地，不需要雲端服務或 API key。

常用指令

初始化專案

mempalace init ~/projects/my_app
mempalace init ~/projects/my_app --yes  # 非互動模式，自動接受

匯入資料

# 匯入專案檔案（程式碼、文件、筆記）
mempalace mine ~/projects/my_app

# 匯入對話記錄（Claude、ChatGPT、Slack 匯出檔）
mempalace mine ~/chats/ --mode convos

搜尋

mempalace search "為什麼改用 GraphQL"
mempalace search "定價討論" --wing my_app --room costs

其他指令

mempalace status                  # 查看已歸檔內容
mempalace wake-up                 # 顯示 L0 + L1 喚醒上下文（~600-900 tokens）
mempalace wake-up --wing my_app   # 特定專案的喚醒上下文
mempalace compress                # 用 AAAK Dialect 壓縮（~30x）
mempalace split <dir>             # 將合併的大檔拆成個別 session 檔
mempalace repair                  # 重建向量索引（修復損壞）
mempalace migrate                 # 跨 ChromaDB 版本遷移
mempalace mcp                     # 顯示 MCP 設定指令

Claude Code MCP 整合

註冊 MCP Server

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

指定自訂 palace 路徑

claude mcp add mempalace -- python -m mempalace.mcp_server --palace /path/to/palace

直接啟動 MCP Server

python -m mempalace.mcp_server

註冊後，下次啟動 Claude Code 會自動載入，提供 29 個 MCP 工具可在對話中使用。

目前設定

• Palace 設定檔：./mempalace.yaml
• MCP 設定位置：~/.claude.json（本專案範圍）
• 預設 palace 存放路徑：~/.mempalace/palace