alibabacloud-supabase

This MCP server connects your Supabase projects to Alibaba Cloud’s Supabase tools, enabling AI assistants to manage Supabase projects, databases, and infrastructure via the MCP protocol. It exposes a set of Aliyun-specific tools grouped under features=aliyun, including project management (list, get, create, delete projects), configuration (manage API keys, IP whitelists, password resets), infrastructure discovery (describe regions, VPCs, and vswitches), and database operations (execute SQL, list tables/columns/indexes/extensions). To use it, deploy the server with an MCP client (like Cursor) and load the provided configuration so your LLMs can call these tools via the MCP interface. You can scope the server to a specific Aliyun project or region using the --project-id and --region-id options, and you can enable read-only mode to prevent any data modification by adding the --read-only flag to the args.

Prerequisites:

• Node.js installed on your machine (Node.js 14+ recommended).
• An MCP client or orchestration environment that supports the MCP JSON configuration format.

Install and run steps:

1. Verify Node.js installation node -v

2. Install or prepare MCP client environment (if using npx-based server, you only need Node.js and npm/yarn available).

3. Run the MCP server via your MCP client using the configuration example. For example, with npx you can start the server by loading the mcp_config JSON into your MCP client, or directly invoke:

npx -y @aliyun-supabase/mcp-server-supabase@latest --features=aliyun

4. Include environment credentials. The configuration can be provided as:

{
  "mcpServers": {
    "supabase": {
      "command": "npx",
      "args": [
        "-y",
        "@aliyun-supabase/mcp-server-supabase@latest",
        "--features=aliyun"
      ],
      "env": {
        "ALIBABA_CLOUD_ACCESS_KEY_ID": "<YOUR_AK>",
        "ALIBABA_CLOUD_ACCESS_KEY_SECRET": "<YOUR_SK>"
      }
    }
  }
}

5. (Optional) If you want to scope to a specific project/region or enable read-only mode, add --project-id, --region-id, or --read-only to the args as shown in the configuration examples.

Tips and notes:

• The server uses Alibaba Cloud credentials. Keep your AK/SK secure and rotate them as needed. You can supply credentials via the provided JSON configuration or environment variables.
• You can scope calls to a specific project or region to avoid traversing all resources by using --project-id and --region-id. These parameters are injected into tool calls when provided.
• Read-only mode (--read-only) wraps write SQL in a transaction and rolls it back to prevent data changes. This is useful for auditing or sandbox environments.
• Tools are organized into Aliyun groups and cover project management, configuration, infrastructure discovery, and database operations (execute_sql, list_table, list_columns, list_indexes, list_extensions).
• The MCP server is labeled as pre-1.0; expect possible breaking changes between versions. Always test tool availability after upgrades.