跨应用的AI记忆：Tablestore OpenMemory MCP

一、部署MCP服务

使用 uv 工具可以在不安装MCP的情况下直接运行服务。

1. 安装uv包管理工具。

   pip3 install uv

2. 配置运行服务需要的环境变量。

   echo "export OPENAI_API_KEY='sk-7*******************************'" >> ~/.bashrc
   echo "export OPENAI_BASE_URL='https://dashscope.aliyuncs.com/compatible-mode/v1'" >> ~/.bashrc
   echo "export TABLESTORE_ENDPOINT='https://k01r********.cn-hangzhou.ots.aliyuncs.com'" >> ~/.bashrc
   echo "export TABLESTORE_INSTANCE_NAME='k01r********'" >> ~/.bashrc
   echo "export TABLESTORE_ACCESS_KEY_ID='LTAI********************'" >> ~/.bashrc
   echo "export TABLESTORE_ACCESS_KEY_SECRET='Jy3H**************************'" >> ~/.bashrc

   配置完成后需要使用 source ~/.bashrc 命令使环境变量生效。环境变量获取方式：

   名称	说明
   OPENAI_API_KEY	前往API-Key管理，查看并复制API-KEY，如果没有API-KEY，单击创建API-KEY创建一个新的API-KEY。
   OPENAI_BASE_URL	https://dashscope.aliyuncs.com/compatible-mode/v1
   TABLESTORE_ENDPOINT	前往表格存储控制台，在实例列表中单击实例别名进入实例管理页面，查看并复制实例名称和实例访问地址。如果使用ECS，根据地域情况选择访问地址： ECS与表格存储在同一地域：选择公网地址或者VPC地址。 ECS与表格存储不在同一地域：选择公网地址。 重要 表格存储新创建的实例默认不开启公网访问，如果要使用公网访问地址，务必在表格存储控制台实例管理的网络管理页签中允许网络类型选中公网，并单击设置保存配置。
   TABLESTORE_INSTANCE_NAME
   TABLESTORE_ACCESS_KEY_ID	阿里云账号或RAM用户的AccessKey ID。
   TABLESTORE_ACCESS_KEY_SECRET	阿里云账号或RAM用户的AccessKey Secret。

   其它可选的环境变量

   名称	说明	默认值
   SERVER_HOST	MCP 服务的运行地址。	0.0.0.0
   SERVER_PORT	MCP 服务的运行端口。	8765
   TABLESTORE_STS_TOKEN	阿里云STS临时访问凭证。	无
   TABLESTORE_VECTOR_DIMENSION	向量维度。	1536
   LLM_MODEL	大语言模型名称。	qwen-plus
   EMBEDDER_MODEL	Embedding模型名称	text-embedding-v4
   TOOL_ADD_MEMORIES_DESCRIPTION	添加记忆工具的描述文字。	Add a new memory. This method is called everytime the user informs anything about themselves, their preferences, or anything that has any relevant information which can be useful in the future conversation. This can also be called when the user asks you to remember something.
   TOOL_SEARCH_MEMORIES_DESCRIPTION	检索记忆工具的描述文字。	Search through stored memories. This method is called EVERYTIME the user asks anything.
   TOOL_LIST_MEMORIES_DESCRIPTION	列举记忆工具的描述文字。	List all memories in the user's memory
   TOOL_DELETE_ALL_MEMORIES_DESCRIPTION	删除记忆工具的描述文字。	Delete all memories in the user's memory

3. 启动MCP服务。

   uvx tablestore-openmemory-mcp --transport=sse

   首次运行需要下载相关依赖，请耐心等待。如遇网络问题导致下载失败，重新执行命令即可。启动后，MCP 服务将在表格存储实例中自动创建所需的数据表及多元索引。当出现以下日志时，表示服务已启动成功。

   INFO:     Started server process [43283]
   INFO:     Waiting for application startup.
   INFO:     Application startup complete.
   INFO:     Uvicorn running on http://0.0.0.0:8765 (Press CTRL+C to quit)

二、连接MCP服务

连接URL格式：http://server_ip:port/mcp/client_name/sse/user_id

• server_ip：运行MCP服务的服务器IP地址。

• port：MCP服务运行端口，默认为8765。

  重要

  访问ECS上的MCP服务，需要在ECS安全组的入方向规则中添加安全组规则，放行MCP服务使用的TCP端口（默认为8765）。

• client_name和user_id：自定义配置，用于隔离不同用户的记忆。

{
  "mcpServers": {
    "tablestore-openmemory": {
      "autoApprove": [
        "add_memories",
        "search_memories",
        "list_memories",
        "delete_all_memories"
      ],
      "disabled": false,
      "timeout": 60,
      "type": "sse",
      "url": "http://47.******.88:8765/mcp/mem0/sse/user0"
    }
  }
}