第 5 课：claude-mem 的 MCP 工具与查询实战
💡 进群学习加 wx: agentupdate
(申请发送: agentupdate)
(申请发送: agentupdate)
5.1 什么是 MCP 工具？
MCP (Model Context Protocol) 工具是让 LLM 主动调用的能力。claude-mem 暴露了三个核心 MCP 工具，用于从其知识库中按需检索信息。
5.2 三大核心工具
| 工具名 | 用途 | 典型查询示例 |
|---|---|---|
search |
全文与向量混合检索，支持类型、日期、项目过滤 | search "Redis 锁失效" |
timeline |
获取特定记录前后相关的时间线上下文 | "看一下这个 Bug 修复前后的讨论" |
get_observations |
通过 ID 获取单条或多条记录的完整详情 | (通常由 search 结果引导) |
5.3 高级查询语法
search 工具支持丰富的过滤语法，帮助 LLM 精确锁定目标：
- 布尔逻辑：
redis AND lock(同时包含),postgres OR mysql(任一包含)。 - 排除关键字：
auth NOT mock。 - 短语匹配：
"connection refused"。 - 元数据过滤：
type:bugfix project:openclaw date:>2026-04-01。
5.4 渐进式披露设计 (Progressive Disclosure)
claude-mem 采用三层检索设计以节省 Token：
- 第一层 (
search)：只返回 ID 和极其紧凑的摘要（每条约 50-100 Tokens）。 - 第二层 (
timeline)：如果 LLM 需要更多背景，可以查询邻近的上下文。 - 第三层 (
get_observations)：只有在确认相关后，才加载完整的记录内容。
这种设计使得 claude-mem 比传统的全量 RAG (检索增强生成) 节省约 10 倍的 Token 消耗。