长记忆使用MCP对接Qoder

前置要求

• Qoder IDE或Qoder 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
# 应输出文件信息，确认路径正确

需要配置的参数

配置来源优先级

方式一：通过MCP注册时的env字段注入（推荐）

注册MCP Server时直接在settings.json的env字段中注入环境变量，无需额外创建配置文件。详见注册MCP Server。

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

创建~/.qoder/adbpgmem.conf（全局）或.qoder/adbpgmem.conf（项目级）配置文件：

# 全局配置（对所有项目生效）
mkdir -p ~/.qoder
cat > ~/.qoder/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 .qoder
cat > .qoder/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调用会失败。

全局注册（推荐）

编辑~/.qoder/settings.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"
      }
    }
  }
}

字段说明

项目级注册

在项目根目录创建.qoder/settings.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"
      }
    }
  }
}

配置AGENTS.md行为指令（可选）

添加到项目根目录的AGENTS.md（Qoder项目级AI行为规范文件，每次会话时自动加载），引导Qoder AI主动使用记忆工具。不配置也不影响MCP工具的正常使用，只是AI不会主动调用。

# MCP Servers

- **adbpgmem**: 持久记忆服务。每次会话开始时先 search_memories 搜索相关上下文，
  发现架构决策、调试经验、编码模式时用 add_memory 保存。
  记忆内容变化时用 update_memory 更新。宁可多记，不可漏记。

怎么使用MCP工具

各工具详细使用说明

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

Qoder AI 调用 add_memory → 服务端存储记忆

你: 记住以下项目决策：我们选择 Kafka 而非 RabbitMQ，因为需要消息回溯能力；
    数据库选用 PostgreSQL 因为需要 JSONB 支持；前端用 React + TypeScript

Qoder AI 调用 add_memory(infer=true) → 服务端提取出 3 条独立的原子事实分别存储

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

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

典型场景使用案例

你: 记住：这个项目使用 Python 3.11 + FastAPI，数据库是 PostgreSQL 15，
    缓存用 Redis 7，消息队列用 Kafka 3.5

Qoder AI 调用 add_memory → 将技术栈信息保存到记忆库

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

会话 2（几天后，新的会话）:
你: 帮我设计一个新的用户管理 API 端点

Qoder AI: 根据之前保存的 API 设计规范，我来设计用户管理端点……
         [自动按照团队规范输出设计，无需重复说明]