claude-mem 中文文档

Appearance

可用性： Claude-mem MCP 工具可在 macOS 和 Windows 上与 Claude Desktop 一起使用。

概览 ​

Claude Desktop 可以通过 MCP 工具 访问你的 claude-mem 内存数据库。这使你能够直接从 Claude Desktop 对话中搜索过去的会话、决策和观察记录。

先决条件 ​

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

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

验证Worker 进程正在运行 ​

bash
curl http://localhost:37777/api/health
# Should return: {"status":"ok"}

安装 ​

第1步：配置MCP服务器 ​

此技能需要 mcp-search MCP 服务器。将其添加到您的 Claude 桌面配置中：

Edit `~/Library/Application Support/Claude/claude_desktop_config.json`:

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


Edit `%APPDATA%\Claude\claude_desktop_config.json`:

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

将 YOUR_USERNAME 替换为您的实际用户名。编辑配置后重新启动 Claude 桌面。

第2步：重启Claude桌面 ​

关闭并重新打开 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 工具，遵循三层工作流程模式：

工具描述
search搜索内存索引。返回带有用于筛选的 ID 的精简结果
timeline获取与查询或观察ID相关的时间顺序上下文
get_observations通过 ID 获取完整的观测详情（在使用搜索/时间线过滤后使用）

token 高效工作流 ​

  1. 搜索 → 获取带有 ID 的索引（每个结果约 50-100 个 token）
  2. 时间轴 → 获取有关有趣结果的背景信息
  3. 获取观测 → 仅获取筛选后的ID的完整详情

这种三层方法相比一次性获取完整细节，可节省约 10 倍的 token 使用量。

故障排除 ​

技能未显示 ​

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

MCP 服务器连接失败 ​

  1. 验证工作进程是否正在运行：curl http://localhost:37777/api/health

  2. 检查配置中的MCP服务器路径

  3. 查找 Claude 桌面日志中的错误

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

    Check %APPDATA%\Claude\logs\

未找到搜索结果 ​

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

相关 ​

  • Search Tools

Complete search API reference

  • Platform Integration

Build custom integrations