MCP

Tablestore MCP:从 Java 入门示例接入表格存储

适合要给智能体接阿里云表格存储的人,前提是克隆官方仓库后进入 Java 入门目录 tablestore-java-mcp-server,不要把答疑示例和入门示例混成一条路径。

官方来源 · Alibaba Cloud Tablestore MCP Server

安装

git clone https://github.com/aliyun/alibabacloud-tablestore-mcp-server
cd alibabacloud-tablestore-mcp-server/tablestore-java-mcp-server

适合谁

如果你要把阿里云表格存储接到智能体里,这个仓库对得上。官方把它写成一组 Tablestore MCP 服务器,产品页是表格存储。

适合已经能克隆 Git 仓库、并准备使用 Java 入门示例的人。官方把 tablestore-java-mcp-server 标成入门示例。没有表格存储实例时,后面的调用没有数据面。

本页没有写出工具函数名,也没有写出 Java 启动行。第一次只进入入门示例目录,不要跳到知识库答疑示例去调问答。

3 分钟完成第一次尝试

官方推荐路径是仓库里的 Java 入门示例 tablestore-java-mcp-server。前置条件:本机能克隆该官方仓库。

执行:

git clone https://github.com/aliyun/alibabacloud-tablestore-mcp-server
cd alibabacloud-tablestore-mcp-server/tablestore-java-mcp-server

克隆地址必须与官方仓库一致:

https://github.com/aliyun/alibabacloud-tablestore-mcp-server

进入入门目录后,用该目录提供的方式启动 MCP,再接到你的客户端。本页没有给出启动命令或环境变量名,不要自行发明 Java 或 Maven 命令,也不要改去打开答疑示例。

连上后做一次调用:在客户端列出的、属于这个入门服务器的工具里任选一个只读项。官方没有连续写出函数名;不要把答疑、知识库或 RAG 当成这个入门示例的工具名。

成功信号:入门服务器已连接,并且客户端返回一次该服务器的工具结果。若目录不存在,先核对克隆的是否为上述官方仓库。

不要同时克隆后进入 tablestore-java-mcp-server-rag。第一次只走 Java 入门目录。

使用案例

案例一:跑通 Java 入门示例。对象是 tablestore-java-mcp-server。按上面克隆并进入该目录,使用客户端列出的入门服务器工具。本页没有函数名,也没有写出表名或主键怎么传。成功时你应看到入门服务器的一次返回。不要假设它已经带了私有知识库问答。

案例二:知识库答疑是另一条官方示例,目录是 tablestore-java-mcp-server-rag。官方说明它实现基于私有知识库的问答,并对知识库构建和 RAG 做一些优化。这不是入门示例,不要把它的问答流程写进第一次尝试。若你要走这条,先单独进入该目录;本页同样没有问答函数名,只使用该示例客户端里实际列出的工具。

使用边界

同一仓库还有 Python 入门 tablestore-python-mcp-server,以及 tablestore-python-mem0-mcp-server。它们都不是第一次尝试的路径。

表格存储产品说明:

https://www.aliyun.com/product/ots

查询会出网访问你的表格存储实例。本页没有写出密钥变量,不要编造。仓库许可是 Apache-2.0。官方没有写撤销。不要把入门示例和答疑示例的工具混用。