RDS Supabase MCP使用指南

通过在QoderCursorIDE中集成RDS Supabase MCP(Model Context Protocol)工具集,开发者可使用自然语言直接与阿里云RDS Supabase实例交互,实现数据库管理与运维任务的自动化,从而简化工作流程并提升开发效率。

RDS Supabase MCP功能介绍

简介

MCP(Model Context Protocol)是一种开放标准协议,旨在为大语言模型(LLM)提供标准化的外部工具和上下文集成方式。RDS Supabase MCP工具提供了一套丰富的工具,将阿里云Supabase项目管理能力与大模型代理(Agent)结合,通过自然语言的方式与运行在阿里云上的RDS Supabase实例进行交互。核心优势如下:

  • 自然语言交互:使用日常对话即可完成复杂的云资源操作。

  • 上下文感知:能够理解对话上下文,简化连续操作的指令。

  • IDE内一站式:无需在IDE和控制台之间频繁切换。

核心功能

  • 数据库架构

    • list_tables:列出模式中的所有表public

    • list_extensions:列出已安装的PostgreSQL扩展。

    • get_database_connections:检索当前数据库连接信息。

    • get_database_stats获取数据库统计信息(例如,表大小)。

  • 用户身份验证管理

    • list_auth_users:列出来自以下位置的用户auth.users

    • get_auth_user:检索特定用户的详细信息。

    • create_auth_user使用 Supabase Admin API 创建新用户。

    • delete_auth_user使用 Supabase Admin API 删除用户。

    • update_auth_user使用 Supabase Admin API 更新用户详细信息。

  • RAG 代理工具(--enable-rag-agent启用时)

    所有RAG Agent 工具都是动态加载的,并以rag_为前缀。

    例如:rag_list_datasetsrag_get_datasetrag_query_datasetrag_query_multi_datasets

    这些工具为语义搜索和文档管理提供检索增强生成功能。连接到阿里云模式下的 Supabase 实例后即可使用。

更多功能(Features)介绍请参考阿里云 RDS Supabase MCP Server

准备工作

  • Qoder或者CursorIDE中具有能够调用Agent能力的模型。

  • 获取阿里云AccessKey

配置RDS Supabase MCP工具

Qoder

  1. 在 Qoder IDE 的右上角,点击用户图标,或使用键盘快捷键(  ,(macOS)或 Ctrl Shift ,(Windows)),然后选择 Qoder 设置

  2. 在左侧导航窗格中,点击MCP 服务

  3. 我的服务选项卡中,点击右上角的 + 添加。复制以下内容到弹出的JSON文件中,并将yourAccessKeyIDyourAccessKeySecret替换为实际值。

    {
       "mcpServers" : {
         "aliyun-supabase" : {
           "command" : "npx" ,
           "args" : [
             "@aliyun-rds/supabase-mcp-server" ,
             "--aliyun-ak" , "YOUR_ACCESS_KEY_ID" ,
             "--aliyun-sk" , "YOUR_ACCESS_KEY_SECRET" ,
             "--aliyun-region" , "cn-hangzhou" 
          ]
        }
      }
    }
    重要

    --aliyun-region参数为必填项。如果没有此参数,即使没有报告任何错误,API 也会返回空的实例列表。常见区域包括:

    • cn-hangzhou(中国东部 1)

    • cn-beijing(中国北方 2)

    • cn-shanghai(中国东部 2)

  4. 保存mcp.json文件后。新服务会出现在MCP服务 > 我的服务列表中,链接图标表示连接成功。展开该条目可以查看可用工具。

    image

Cursor

说明

您可以单击aliyun-supabaseCursor中快速安装MCP,或通过以下方法完成配置。

  1. Cursor中,导航至Cursor Setting>Tools & Integrations>MCP Tools,单击New MCP Server,打开.cursor/mcp.json文件。

  2. 复制以下内容到文件中,并将 yourAccessKeyID 和 yourAccessKeySecret 替换为实际值。

    {
       "mcpServers" : {
         "aliyun-supabase" : {
           "command" : "npx" ,
           "args" : [
             "@aliyun-rds/supabase-mcp-server" ,
             "--aliyun-ak" , "YOUR_ACCESS_KEY_ID" ,
             "--aliyun-sk" , "YOUR_ACCESS_KEY_SECRET" ,
             "--aliyun-region" , "cn-hangzhou" 
          ]
        }
      }
    }
    重要

    --aliyun-region参数为必填项。如果没有此参数,即使没有报告任何错误,API 也会返回空的实例列表。常见区域包括:

    • cn-hangzhou(中国东部 1)

    • cn-beijing(中国北方 2)

    • cn-shanghai(中国东部 2)

  3. 保存.cursor/mcp.json文件。

    您将看到Supabase服务已成功添加到Cursor Setting>Tools & Integrations>MCP Tools列表中,并包含一系列可用工具。

    image

使用示例(Qoder)

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

查询Supabase项目列表

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

Qoder Agent会自动解析您的意图,并调用相应的MCP工具aliyun-supabase/list_aliyun_supabase_projects。如果缺少必要参数(如地域 ID),它会智能推断并最终返回格式化的项目列表。

image

获取单个项目的详细信息

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

Qoder Agent会从上文对话中获取项目 ID,并调用aliyun-supabase/get_current_supabase_instance工具,返回项目的详细配置。

image

列出已安装的PostgreSQL扩展插件

用户指令:列出已安装的PostgreSQL扩展。

Qoder Agent会从上文对话中获取当前连接实例ID,并调用aliyun-supabase/list_extensions工具,返回当前连接实例已安装的PostgreSQL扩展。

image

相关文档

关于阿里云 RDS Supabase MCP Server 的更多详细信息,请参考其官网文档