alibabacloud-agentloop-memory-mcp-server

阿里云 AgentLoop MemoryStore 的 MCP Server 实现，为 AI Agent 提供长期记忆管理能力，支持通过 MCP 协议（SSE 传输）进行记忆的增删改查和语义搜索。

AgentLoop MemoryStore

AgentLoop MemoryStore 是阿里云提供的全托管 AI Agent 长期记忆服务。它为 AI Agent 提供智能记忆层，使其能够跨会话记住用户偏好、持续学习并实现个性化交互，适用于智能客服、个人助理、教育辅导等场景。

核心特性：

• 多维度记忆：自动从对话中提取用户偏好、事实陈述、会话摘要等结构化记忆，支持自定义提取策略
• 分层检索：L1 混合检索 → L2 Rerank 精排 → L3 Agentic Search，兼顾召回广度与精度
• 异步提取：记忆处理异步执行，不阻塞 Agent 主流程，支持弹性扩缩容
• 全托管：无需搭建向量数据库或维护存储实例，开通即用
• 可观测：内置监控大盘，覆盖检索延迟、Token 消耗、存储量等核心指标

本项目将 AgentLoop MemoryStore 封装为标准 MCP Server，支持 Cursor、Claude Desktop 等 MCP 客户端直接接入。

安装

pip install alibabacloud-agentloop-memory-mcp-server

快速开始

1. 配置环境变量

export ALIBABA_CLOUD_ACCESS_KEY_ID=your_access_key_id
export ALIBABA_CLOUD_ACCESS_KEY_SECRET=your_access_key_secret
export ALIBABA_CLOUD_REGION_ID=cn-hangzhou
export ALIBABA_CLOUD_WORKSPACE=your_workspace_name
export ALIBABA_CLOUD_MEMORY_STORE=your_memory_store_name

2. 启动服务

# 使用 python -m 启动
python -m mcp_server_agentloop_memory

# 或使用命令行入口
alibabacloud-agentloop-memory-mcp-server

# 指定参数启动
python -m mcp_server_agentloop_memory \
  --access-key-id <your_ak_id> \
  --access-key-secret <your_ak_secret> \
  --region-id cn-hangzhou \
  --workspace <workspace_name> \
  --memory-store <memory_store_name> \
  --port 8080

3. 连接 MCP Client

服务启动后，MCP Client 通过 SSE 连接：

GET http://localhost:8080/mcp/{client_name}/sse/{user_id}

• client_name：客户端标识（如 cursor、my-agent），映射为 agent_id
• user_id：用户标识，用于隔离不同用户的记忆数据

CLI 参数

MCP Tools

权限要求

需要阿里云 RAM 用户具有 AgentLoop MemoryStore 相关 API 的访问权限。获取和管理 AccessKey 请参考阿里云 AccessKey 管理。

开发

# 安装开发依赖
pip install -e ".[dev]"

# 运行测试（需要配置环境变量）
pytest tests/ -v