Claude Desktop MCP

概述¶

Claude Desktop 可以通过 MCP 工具访问您的 claude-mem 记忆数据库。这让您可以直接在 Claude Desktop 对话中搜索过去的会话、决策和观察记录。

先决条件¶

在配置 MCP 工具之前，请确保：

1. claude-mem 已安装，并且 Worker Service 正在运行
2. MCP 服务器已配置到 Claude Desktop（使用 mcp-search MCP 服务器）

验证 Worker 是否正在运行¶

WORKER_PORT=$(jq -r .CLAUDE_MEM_WORKER_PORT ~/.claude-mem/settings.json)
curl http://127.0.0.1:$WORKER_PORT/api/health
# Should return: {"status":"ok"}

安装¶

步骤 1：配置 MCP 服务器¶

该技能需要使用 mcp-search MCP 服务器。请将此部分添加到您的 Claude Desktop 配置中：

{
  "mcpServers": {
    "mcp-search": {
      "command": "node",
      "args": [
        "/Users/YOUR_USERNAME/.claude/plugins/marketplaces/thedotmack/plugin/scripts/mcp-server.cjs"
      ]
    }
  }
}

{
  "mcpServers": {
    "mcp-search": {
      "command": "node",
      "args": [
        "C:\\Users\\YOUR_USERNAME\\.claude\\plugins\\marketplaces\\thedotmack\\plugin\\scripts\\mcp-server.cjs"
      ]
    }
  }
}

步骤 2：重启 Claude Desktop¶

关闭并重新打开 Claude Desktop，以使 MCP 服务器配置生效。

使用¶

安装后，当您询问过去的工作时，该技能会自动激活：

"What did we do last session?"
"Did we fix this bug before?"
"How did we implement authentication?"
"What decisions did we make about the API?"
"Show me changes to worker-service.ts"

可用的 MCP 工具¶

该技能提供三个核心 MCP 工具，遵循三层工作流模式：

Token 高效工作流¶

1. Search → 获取带有 ID 的索引（约 50–100 Token/结果）
2. Timeline → 获取感兴趣结果周围的上下文
3. Get Observations → 仅针对过滤后的 ID 获取完整详情

与预先获取完整详细信息相比，这种三层方法可节省约 10 倍的 Token。

故障排除¶

技能未显示¶

1. 验证 zip 文件是否正确安装
2. 检查 Claude Desktop 的技能安装日志
3. 重启 Claude Desktop

MCP 服务器连接失败¶

1. 验证 Worker 是否正在运行：curl http://127.0.0.1:$WORKER_PORT/api/health
2. 检查配置中的 MCP 服务器路径
3. 在 Claude Desktop 日志中查找错误

# View Claude Desktop logs
tail -f ~/Library/Logs/Claude/claude.log

搜索未返回结果¶

1. 确保 claude-mem 已记录会话（检查 http://127.0.0.1:$WORKER_PORT）
2. 确认数据库存在：ls ~/.claude-mem/claude-mem.db
3. 直接测试 API：curl "http://127.0.0.1:$WORKER_PORT/api/search?query=test"

相关¶

搜索工具

完整的搜索 API 参考

平台集成

构建自定义集成