长记忆使用MCP对接Claude Code

前置要求

• Claude Code CLI已安装并可正常使用。

• Python >= 3.10。

• uv包管理器（用于uvx按需启动，推荐使用）。

• 已获取AnalyticDB for PostgreSQL长记忆服务的API地址和Token。获取方式请参见上下文服务。

• 已获取adbpgmem_mcp_selfhosted项目源码adbpgmem-mcp-server-0.2.0.tar.gz。

  请将压缩包解压到指定目录 adbpgmem_mcp_selfhosted，后续步骤中的路径均指向该解压目录。

安装步骤

MCP Server无需预先全局安装，uvx会从本地项目路径按需创建临时虚拟环境并启动服务。只需确保源码路径可访问即可。

# 确认源码路径可用
ls /path/to/adbpgmem_mcp_selfhosted/pyproject.toml
# 应输出文件信息，确认路径正确

需要配置的参数

方式一：注册时通过--env注入（推荐）

注册MCP Server时直接通过--env参数注入环境变量，无需额外创建配置文件。详见下方「注册MCP Server」章节。

方式二：手动编写配置文件

全局配置（对所有项目生效）：

mkdir -p ~/.claude
cat > ~/.claude/adbpgmem.conf << 'EOF'
ADBPGMEM_API_URL="https://api-longmemory-cn-chengdu.opentrust.net"
ADBPGMEM_API_TOKEN="sk-your-token-here"
ADBPGMEM_USER_ID="your.username"
EOF

项目级配置（仅对当前项目生效）：

mkdir -p .claude
cat > .claude/adbpgmem.conf << 'EOF'
ADBPGMEM_API_URL="https://api-longmemory-cn-chengdu.opentrust.net"
ADBPGMEM_API_TOKEN="sk-your-token-here"
ADBPGMEM_USER_ID="your.username"
EOF

配置文件说明

配置文件格式为KEY="VALUE"，每行一个配置项。配置缺失时MCP Server会记录警告并继续启动，但API调用会失败。

全局注册（推荐）

写入~/.claude.json，对所有项目生效：

claude mcp add --scope user --transport stdio adbpgmem \
  --env ADBPGMEM_API_URL=https://api-longmemory-cn-chengdu.opentrust.net \
  --env ADBPGMEM_API_TOKEN=sk-your-token-here \
  --env ADBPGMEM_USER_ID=your.username \
  -- uvx --from /path/to/adbpgmem_mcp_selfhosted adbpgmem-mcp-server

命令说明：

项目级注册

通过项目根目录的.mcp.json文件注册，仅对当前项目生效，可纳入版本管理供团队共享：

{
  "mcpServers": {
    "adbpgmem": {
      "command": "uvx",
      "args": ["--from", "/path/to/adbpgmem_mcp_selfhosted", "adbpgmem-mcp-server"],
      "env": {
        "ADBPGMEM_API_URL": "https://api-longmemory-cn-chengdu.opentrust.net",
        "ADBPGMEM_API_TOKEN": "sk-your-token-here",
        "ADBPGMEM_USER_ID": "your.username"
      }
    }
  }
}

验证注册

检查MCP Server是否注册成功：

# 检查 MCP Server 是否注册成功
claude mcp list
# 输出中应包含 adbpgmem

# 启动 Claude Code 后输入 /mcp，查看状态是否为 ✓ Connected

调用方式

MCP工具由Claude根据对话上下文自主决策调用，用户通过自然语言触发：

各工具详细使用说明

你: 记住：这个项目使用 Go 1.22 + Gin 框架，ORM 使用 GORM v2，数据库是 PostgreSQL 15

Claude 调用 add_memory → 服务端存储记忆

你: 搜索一下之前关于数据库选型的记忆

Claude 调用 search_memories → 返回语义匹配的历史记忆

场景一：搜索历史调试经验

背景：您遇到了一个Docker容器内存溢出的问题，想查看之前有没有相关经验。

操作：

你: 搜索一下之前有没有遇到过 Docker 容器 OOM 的问题

Claude行为：

1. 识别到搜索意图。

2. 调用search_memories(query="Docker 容器 OOM 内存溢出")。

3. 返回匹配的历史记忆。

输出示例：

找到 1 条相关记忆：

1. [score: 0.91] Java 应用在 Docker 容器中需设置 -XX:MaxRAMPercentage=75.0
   和 -XX:+UseContainerSupport，否则 JVM 无法正确识别容器内存限制，
   导致超出容器 limit 被 kill。

场景二：跨会话知识复用

背景：上一次会话中确定了API设计规范，这次会话需要开发新的API端点。

会话1：

你: 记住：我们的 API 统一使用 RESTful 风格，分页参数用 page/page_size，
    排序用 sort=field:asc|desc，错误响应包含 type/title/status/detail 四个字段

会话2（几天后，新的会话）：

你: 帮我设计一个新的用户管理 API 端点

Claude: 根据之前保存的 API 设计规范，我来设计用户管理端点：
       - 列表接口支持分页和排序
       - 错误响应统一使用四字段格式
       - 遵循 RESTful 命名风格

       [自动按照团队规范输出设计，无需您重复说明]

Claude自动从记忆库中找到上次确定的规范，新会话无需重复沟通，直接复用团队共识。