Aliyun Supabase

🎉 Supabase on Alibaba Cloud is FREE! Deploy Supabase for free on Alibaba Cloud today.

Free for Developers: Learn more about our product Supabase on Alibaba Cloud (AnalyticDB for PostgreSQL) - available at no cost.

Learn more about Alibaba Cloud Supabase MCP.

Supabase MCP Server

Connect your Supabase projects to Cursor, Claude, Windsurf, Lingma, Qoder, and other AI assistants.

The Model Context Protocol (MCP) standardizes how Large Language Models (LLMs) talk to external services like Supabase. It connects AI assistants directly with your Supabase project and allows them to perform tasks like managing tables, fetching config, and querying data. See the full list of tools.

Prerequisites

You will need Node.js installed on your machine. You can check this by running:

node -v

If you don't have Node.js installed, you can download it from nodejs.org.

Setup

1. Aliyun AK & SK

First, go to your Aliyun console and create a personal access key. Give it a name that describes its purpose, like "Cursor MCP Server".

This will be used to authenticate the MCP server with your Supabase account. Make sure to copy the token, as you won't be able to see it again.

2. Configure MCP client

Next, configure your MCP client (such as Cursor) to use this server. Most MCP clients store the configuration as JSON in the following format:

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

Replace <ALIYUN_ACCESS_TOKEN> with the token you created in step 1.

Alternatively, you can use the separate environment variables:

{
  "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>"
      }
    }
  }
}

Scoping to a Specific Aliyun Project

To scope the MCP server to a specific Aliyun project and avoid traversing all regions and projects, you can use the --project-id and --region-id flags:

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

When --project-id is specified:

• All Aliyun tools will automatically use this project ID
• The project_id parameter will be automatically injected and removed from tool parameters
• You won't need to specify the project ID when calling tools

When --region-id is specified:

• All Aliyun tools will automatically use this region ID
• The region_id parameter will be automatically injected and removed from tool parameters
• This helps avoid traversing all regions to find projects

Note: Both --project-id and --region-id are optional. If not specified, tools will work as before, requiring you to provide these parameters when calling tools.

Read-Only Mode

For enhanced security, especially

... View full README on GitHub