MaxCompute MCP Server

Overview

A Model Context Protocol (MCP) server for MaxCompute.

Components

Tools

The server offers 4 core tools:

Query Tools

• get_latest_partition
• Get the latest partition name for a specific table
• Input:
• table_name (string): Name of the table
• Returns: The latest partition name

• read_query
• Execute a SELECT query on the MaxCompute project, only SELECT query is allowed
• Input:
• query (string): The SELECT SQL query
• Returns: Query results as array of objects

Schema Tools

• list_tables
• List all tables in the MaxCompute project
• No input required
• Returns: Array of table objects with name and comment

• describe_table
• Get the schema information for a specific table
• Input:
• table_name (string): Name of the table
• Returns: Raw output of DESC command

Build from source

• Code: GitHub

cd /path/to/maxcompute-mcp-server
uv pip install .
uv build

Usage with Cline

• maxcompute endpoints can view in endpoint

• maxcompute projects can view in projects

# Add the server to your cline_mcp_settings.json
"mcpServers": {
  "maxcompute-mcp-server": {
    "command": "uv",
    "args": [
      "run",
      "--with",
      "maxcompute-mcp-server",
      "maxcompute-mcp-server"
    ],
    "env": {
      "ALIBABA_CLOUD_ACCESS_KEY_ID": "",
      "ALIBABA_CLOUD_ACCESS_KEY_SECRET": "",
      "ALIBABA_CLOUD_MAXCOMPUTE_PROJECT": "",
      "ALIBABA_CLOUD_MAXCOMPUTE_ENDPOINT": "https://service.cn-shanghai.maxcompute.aliyun.com/api"
    }
  }
}