Supabase MCP使用_云原生数据仓库AnalyticDB(AnalyticDB)-阿里云帮助中心

开发过程中，您可以通过通义灵码或Cursor，在IDE中以自然语言调用Supabase MCP（Model Control Plane）工具，从而完成Supabase项目的创建、查询与删除等操作，无需离开编码环境，显著提升开发与运维效率。

Supabase MCP简介

MCP(Model Context Protocol)是一种开放标准协议，旨在为大语言模型（LLM）提供标准化的外部工具和上下文集成方式。Supabase MCP工具，将阿里云Supabase项目管理能力与大模型代理（Agent）结合，支持通过自然语言交互的方式，实现对阿里云Supabase项目的全生命周期管理。核心优势如下：

自然语言交互：使用日常对话即可完成复杂的云资源操作。
上下文感知：通义灵码能够理解对话上下文，简化连续操作的指令。
IDE内一站式：无需在IDE和控制台之间频繁切换。

准备工作

在您的IDE（如Visual Studio Code）中安装和登录通义灵码插件，或者在Cursor中具有能够调用Agent能力的模型。

配置Supabase MCP工具

Visual Studio Code+通义灵码

获取AccessKey。
在Visual Studio Code中打开通义灵码，切换到智能体模式，单击MCP工具。
在MCP服务管理界面，单击右上角的➕号，选择配置文件添加。

将以下内容复制到lingma_mcp.json文件编辑器中，并将 yourAccessKeyID 和 yourAccessKeySecret 替换为实际值。

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

保存lingma_mcp.json文件。
您将看到Supabase服务及一系列可用工具已成功添加到我的服务列表中。这些工具包含阿里云官方提供的Supabase API，涵盖了项目管理的全部核心功能；同时，您也可以直接调用相应的MCP工具直接执行SQL。

Cursor

获取AccessKey。

在项目根目录添加.cursor/mcp.json文件，复制以下内容到文件中，并将 yourAccessKeyID 和 yourAccessKeySecret 替换为实际值。

{
  "mcpServers": {
    "supabase": {
      "command": "npx",
      "args": [
        "-y",
        "@aliyun-supabase/mcp-server-supabase@latest",
        "--features=aliyun",
        "--read-only"
      ],
      "env": {
        "ALIYUN_ACCESS_TOKEN": "yourAccessKeyID|yourAccessKeySecret"
      }
    }
  }
}

保存.cursor/mcp.json文件。
您将看到Supabase服务已成功添加到Cursor Setting>Tools & Integrations>MCP Tools列表中，并包含一系列可用工具。

使用示例

配置Supabase MCP工具后，您可以在通义灵码的对话框中，通过自然语言管理Supabase项目。

查询Supabase项目列表

用户指令：列出我在阿里云上所有supabase projects

通义灵码会自动解析您的意图，并调用相应的MCP工具supabase/list_aliyun_supabase_projects。如果缺少必要参数（如地域 ID），它会智能推断并最终返回格式化的项目列表。

获取单个项目的详细信息

用户指令：查询这个project的详细信息，不要显示敏感信息

通义灵码会从上文对话中获取项目 ID，并调用supabase/get_supabase_project工具，返回项目的详细配置。

在同一VPC中创建新项目

用户指令：在同一个vpc再创建一个supabase project

通义灵码会自动从上文获取VPC ID等网络信息，调用supabase/create_supabase_project工具执行创建。

删除新创建的项目

用户指令：删除刚创建的project

通义灵码会准确识别“刚创建的project”，调用supabase/delete_supabase_project工具执行删除。

实战场景-前端开发者分钟级完成后端配置

对于前端开发者而言，快速构建用户界面和交互逻辑是核心价值体现。然而，在项目启动阶段，后端服务配置（如数据库连接）往往繁琐且耗时，极易打断编码节奏。

本章节以实际开发场景展开，介绍一位前端开发者如何利用Supabase MCP构建“仓储物流管理系统”。开发者无需离开IDE，仅通过几句简单自然语言对话，即可在几分钟内完成从“发现云端Supabase服务”到“本地项目配置连接成功”的完整操作。

场景描述

一位前端开发者在构建“仓储物流管理系统”时，已经完成了“仓储物流管理系统”的UI界面开发，但需要将纯前端应用连接到云端的Supabase项目，以实现数据的动态加载和管理。

使用Supabase MCP高效配置

通过以下自然语言指令，开发者可以在几分钟内完成从发现云端Supabase服务到本地项目配置的全过程：

列出我在阿里云上所有supabase projects
选择项目sbp-5qo2zxpowmhlxxxx，获取VITE_SUPABASE_URL和VITE_SUPABASE_ANON_KEY，应用到仓储物流库存管理系统的.env文件
通义灵码会从对话中获取项目ID，调用supabase/get_supabase_project工具获取配置信息，并自动写入本地项目的.env文件。

优势

Supabase MCP为前端开发者带来以下价值：

聚焦前端开发：让前端开发者从繁琐的后端配置中解放出来，专注于UI和业务逻辑。
简化工作流：将原本需要跨多个应用、执行多个步骤的复杂任务，简化为在IDE内的一两次自然语言对话。
杜绝配置错误：自动化获取和写入凭证，从根源上消除了手动复制粘贴引入的低级错误，节省大量调试时间。
加速开发进程：极大地缩短了从项目启动到“Hello World”跑通的时间，尤其是在需要频繁切换和搭建不同后端环境的场景中，效率提升尤为显著。

Supabase MCP改变了前端与后端的协作模式，让后端配置不再是障碍，而是一个可以“对话”完成的简单任务。

常见问题

为什么Visual Studio Code中无法执行MCP工具？

如果您在Visual Studio Code中已完成Supabase MCP工具配置，但是智能体仍然无法自动执行MCP工具，请检查Visual Studio Code设置，确认已启用智能体自动执行MCP工具。

启用方法：打开Visual Studio Code的设置页面，搜索Mcp Tools In Agent Mode，启用允许智能体自动执行MCP工具。

如何解决Supabase MCP安装报错“No matching version found for @mjackson/multipart-parser@^0.10.1.”？

该报错可能与您的npm版本有关，如果您的npm版本为v11.4.x，请更新此版本后重试安装。

关于MCP服务在安装和运行过程中的更多问题，请参见MCP常见问题说明。