AI导哈

记忆管理服务

阿里云提供的全托管AI Agent长期记忆服务，支持记忆的增删改查和语义搜索，适用于智能客服、个人助理等场景。

  • by aliyun
  • Python
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 aliyun/alibabacloud-agentloop-memory-mcp-server

使用说明

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 参数

参数 环境变量 默认值 说明
--access-key-id ALIBABA_CLOUD_ACCESS_KEY_ID - 阿里云 AccessKey ID
--access-key-secret ALIBABA_CLOUD_ACCESS_KEY_SECRET - 阿里云 AccessKey Secret
--region-id ALIBABA_CLOUD_REGION_ID cn-hangzhou 阿里云区域
--workspace ALIBABA_CLOUD_WORKSPACE - Workspace 名称
--memory-store ALIBABA_CLOUD_MEMORY_STORE - Memory Store 名称
--host - 0.0.0.0 监听地址
--port - 8080 监听端口
--log-level - INFO 日志级别

MCP Tools

工具名 参数 说明
add_memories text: str 添加记忆。当用户分享个人信息、偏好或要求记住某些内容时调用
search_memory query: str 语义搜索记忆。用户提问时自动调用，返回按相关度排序的记忆
list_memories 无 列出当前用户的所有记忆
delete_memories memory_ids: list[str] 按 ID 删除指定记忆
delete_all_memories 无 删除当前用户的所有记忆

权限要求

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

开发

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

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

相关 MCP