MCP

Tablestore MCP: connect Table Store from the Java intro sample

For people who want to attach Alibaba Cloud Tablestore to an agent, after cloning the official repo and entering the Java intro directory tablestore-java-mcp-server. Do not merge the Q&A sample and the intro sample into one path.

Official source · Alibaba Cloud Tablestore MCP Server

Install

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

Who it's for

If you want to attach Alibaba Cloud Tablestore to an agent, this repository matches. Official text describes it as a set of Tablestore MCP servers. The product page is Table Store.

It suits people who can already clone a Git repository and plan to use the Java intro sample. Official text marks tablestore-java-mcp-server as the intro sample. Without a Table Store instance, later calls have no data plane.

This page writes no tool function names and no Java start line. The first time, only enter the intro-sample directory; do not jump to the knowledge-base Q&A sample to call Q&A.

First try in 3 minutes

The official recommended path is the Java intro sample tablestore-java-mcp-server in the repository. Prerequisite: this machine can clone that official repository.

Run:

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

The clone URL must match the official repository:

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

After you enter the intro directory, start MCP the way that directory provides, then connect it to your client. This page gives no start command and no environment-variable names. Do not invent Java or Maven commands, and do not switch to opening the Q&A sample.

After you are connected, make one call: among the tools the client shows that belong to this intro server, pick any read-only item. Official text does not consecutively write function names; do not treat Q&A, knowledge base or RAG as tool names of this intro sample.

Success: the intro server is connected, and the client returns one tool result from that server. If the directory is missing, first check that what you cloned is the official repository above.

Do not clone and then enter tablestore-java-mcp-server-rag in the same first pass. The first time, only take the Java intro directory.

Use cases

Case 1: get the Java intro sample running. The object is tablestore-java-mcp-server. Clone and enter that directory as above, and use the intro-server tools the client shows. This page has no function names, and it does not say how to pass a table name or primary key. On success you should see one return from the intro server. Do not assume it already includes private knowledge-base Q&A.

Case 2: knowledge-base Q&A is another official sample. Its directory is tablestore-java-mcp-server-rag. Official text says it implements Q&A on a private knowledge base and does some optimization for knowledge-base construction and RAG. That is not the intro sample; do not write its Q&A flow into the first try. If you take this path, enter that directory on its own. This page likewise has no Q&A function names; only use the tools actually shown in that sample's client.

Limits

The same repository also has the Python intro tablestore-python-mcp-server, and tablestore-python-mem0-mcp-server. Neither is the first-try path.

Table Store product notes:

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

Queries leave this machine over the network to your Table Store instance. This page writes no key-variable names; do not invent them. The repository license is Apache-2.0. Official text writes no undo. Do not mix tools from the intro sample and the Q&A sample.