This MCP server bundle provides Apache Alibaba Cloud Tablestore (OTS) integration examples in both Java and Python. The Java entry point typically runs a Java-based MCP server JAR that exposes an interface for handling data-plane requests, while the Python entry point runs a Python-based MCP server module. These servers enable you to experiment with common MCP workflows such as data indexing, querying, and batching, and often include starter examples like basic CRUD handlers and Q&A/RAG-style demos. To use them, start both the Java and Python MCP servers (if you need cross-language demos) and point your MCP client to the corresponding endpoints. The Java server exposes its functionality via the jar entry, and the Python server runs as a Python module; once running, you can plug in your own handlers or follow the provided example implementations to build higher-level AI-assisted applications or knowledge-base tools that leverage Tablestore' s scalable storage.

Prerequisites:

• Java Development Kit (JDK 8+) or higher
• Python 3.8+ (optional for Python MCP server)
• Git
• Alibaba Cloud credentials configured if you plan to access Tablestore services

Installation steps:

1. Clone the repository containing the MCP servers: git clone https://github.com/aliyun/alibabacloud-tablestore-mcp-server.git
2. Navigate to the project directories for the servers you want to run, for example: cd tablestore-java-mcp-server

   or

   cd tablestore-python-mcp-server
3. Build/prepare the Java server (if a build tool is provided) or ensure the jar is available:
   • If using Maven/Gradle, run the build command as specified in the repository (e.g., mvn package or gradle build)
   • Ensure tablestore-java-mcp-server.jar is present in the project root or the expected path
4. Install Python MCP server dependencies (if applicable):
   • python -m venv venv
   • source venv/bin/activate # or .\venv\Scripts\activate on Windows
   • pip install -r requirements.txt
5. Start the servers:
   • Java MCP server: java -jar tablestore-java-mcp-server.jar
   • Python MCP server: python -m tablestore_python_mcp_server
6. Verify the servers are running by checking logs or hitting the health endpoints defined by the MCP framework in the project.

Note: If you plan to deploy in production, configure proper environment variables (see additional_notes) and ensure network access to Alibaba Cloud Tablestore endpoints.

Environment variables and configuration tips:

• Ensure Alibaba Cloud credentials (AccessKey ID/Secret) are configured if your MCP servers interact with Tablestore services.
• If the MCP servers expose endpoints for batching or Q&A/RAG workflows, consider enabling logging levels (INFO/DEBUG) to help diagnose issues.
• Check for Java version compatibility with the tablestore-java-mcp-server.jar; some older examples require JDK 8-11.
• For the Python MCP server, ensure dependencies in requirements.txt are compatible with your Python environment and consider using a virtual environment.
• If you encounter port conflicts, customize the server port via their respective configuration options or command-line flags as documented in their READMEs.
• If you are integrating with a front-end or an orchestration layer, confirm the MCP protocol version and the endpoint paths used by both Java and Python servers to ensure compatibility.