mempalace-light-mcp 與 PQL

mempalace-light-mcp 是 v3.10.0 新增的輕量 MCP server：用 3 個工具 + Palace Query Language（PQL） 覆蓋完整版 45 工具的能力面，schema 從 41.6 KB 縮到 10.6 KB——約四分之一。

為什麼需要輕量版

完整版 MCP server 有 45 個工具。每一個 agent session 都要全額載入這份 schema——對「只想搜尋與協調」的輕量 agent 來說，其餘工具的 schema 定義是純粹的 token 開銷。多次部署、多 agent fleet 的場景下，這個成本會乘上 session 數。

三個工具

工具	涵蓋
`palace_query`	搜尋、taxonomy、KG、graph、diary、drawers、mining、tunnels
`palace_exec`	寫入與採礦操作
`palace_coordinate`	RFC 003 協調（events、tasks、ack）

Palace Query Language（PQL）

查詢用一行字串表達：

FIND "oauth" IN backend/auth LIMIT 5

也可以傳結構化 dict（等價表達）。兩種形式走同一套解析，複雜查詢偏好 dict 形式以便組合。

安全程式不縮水

輕量版不是「功能閹割版」，安全性質與完整版一致：

寫入走相同的 sanitizing handlers——drawer 文字維持 verbatim（逐字）
搜尋排名不變
stdio 傳輸是 hub-first（優先重用共用 Hub，不另載索引）
--read-only 模式拒絕 palace_exec 與 palace_coordinate（唯讀就真的唯讀）

安裝

與完整版並存，不是取代——要完整工具面的 agent 繼續用 mempalace-mcp，輕量 agent 加掛 light 版：

claude mcp add mempalace-light -- mempalace-light-mcp

搭配 v3.10.0 的身分規則

v3.10.0 的 shared-brain rules 改用 host:harness:project 三元身分，且 mempalace rules 支援 --mcp full|light 指定規則要命名哪個工具面：

mempalace rules --host myhost --harness claude --project myapp --mcp light

何時選 light、何時選 full

場景	建議
只做搜尋 / 回想的 agent	light
參與 RFC 003 協調的 worker	light（`palace_coordinate` 夠用）
需要 mining、diary、KG 全工具面的主 agent	full
不確定	先 light，需要時補 full——兩者可並存同一台主機

學習重點

「同一後座、兩個工具面」是 token 經濟學的實作：省 75% schema 不是換後端、不是刪功能，而是把查詢面收斂成一套表達語言（PQL）。任何「工具很多但每個 session 只用其中幾個」的 MCP server 都可以套用這個模式。

來源：v3.10.0

MemPalace

mempalace-light-mcp 與 Palace Query Language