Supabase MCP对接使用

以下步骤介绍公网环境下如何通过Claude对接并使用Supabase MCP。

1. 参考查看API Key，获取API Key，包含Anon Key和Service Role Key。
   图1 Supabase应用API Key列表
   

2. 开启Supabase应用公网访问，为其绑定一个连通外部网络的弹性公网IP。
   • 方式一：参考绑定和解绑DNAT网关地址，绑定DNAT网关，并在应用详情页获取绑定的EIP和访问端口。
     图2 Supabase应用网络信息页面
     
   • 方式二：参考绑定和解绑弹性公网IP，直接绑定EIP，并在应用详情页获取绑定的EIP地址。
     图3 Supabase应用网络信息页面（弹性公网IP信息）
     

3. 在Supabase应用详情页，单击托管实例名称，进入实例详情页。
4. 在左侧导航栏，选择“连接管理”，参考绑定和解绑弹性公网IP，为托管的数据库实例绑定EIP。
   图4 托管数据库实例连接信息
   

   如上图所示，获取实例的公网地址和数据库端口。

5. 本地安装Bun工具，请确保您的网络正常，可正常访问互联网资源。

   Bun工具是一款快速、现代的一体化JavaScript、TypeScript与JSX工具包，用于部署Supabase MCP Server。

   • Linux & MacOS

     curl -fsSL https://bun.sh/install | bash

   • Windows

     powershell -c "irm bun.sh/install.ps1 | iex"

6. 下载Supabase MCP Server开源项目源码到本地目录，并通过Bun来安装相关依赖。
   执行前请再次检查，确保已安装Git工具。详细安装操作，请参见Git官网。

   git clone https://github.com/HenkDz/selfhosted-supabase-mcp.git
   cd selfhosted-supabase-mcp
   bun install

7. 打开Claude的配置文件（.claude.json），在mcpServers中添加Supabase MCP Server相关配置，模板如下所示。

   {
       "mcpServers": {
           "selfhosted-supabase": {
               "command": "bun", 
               "args": [
                   "run", 
                   "<path-to-mcp-code-dist>/selfhosted-supabase-mcp/src/index.ts", 
                   "--url", 
                   "<your-supabase-url>", 
                   "--anon-key", 
                   "<your-anon-key>", 
                   "--service-key", 
                   "<your-service-role-key>", 
                   "--db-url", 
                   "<your-db-url>"
               ]
           }
       }
   }

   配置参数填写说明如表11，请结合实际的应用和托管实例相关配置信息，进行正确填写，替换掉<xxx>的整个内容（包含<和>符号）。

   表11 Supabase MCP对接配置参数填写规则

   参数项	是否必填	取值说明	取值示例	注意事项
   <path-to-mcp-code-dist>	是	填写本地下载的Supabase源码的根目录。	D:/workspace/rds-supabase/mcp/	确保其目录下已下载selfhosted-supabase-mcp git项目，文件夹存在。
   <your-supabase-url>	是	填写Supabase应用的公网访问地址。格式为： 已开启SSL：http(s)://Supabase应用的EIP:Supabase应用的访问端口 未开启SSL：http://Supabase应用的EIP:Supabase应用的访问端口	http://10.0.0.0:8443	确保本地能访问该IP地址。
   <your-anon-key>	是	填写Supabase应用的Anon Key。	**********	如果Anon Key进行了重置操作，请填写最新生效的API Key的取值。
   <your-service-role-key>	否	填写Supabase应用的Service Role Key。	**********	如果Service Role Key进行了重置操作，请填写最新生效的API Key的取值。
   <your-db-url>	否	填写Supabase应用托管的PostgreSQL数据库实例的直连地址。 格式为： postgresql://root:<登录密码>@<实例EIP>:<实例访问端口>/<数据库名称> <登录密码>：填写托管的数据库实例root账号的密码。 <实例EIP>：填写托管的数据实例的EIP。 <实例访问端口>：填写托管的数据实例的访问端口，一般默认为5432。 <数据库名称>：填写实例上Database的名称，当前仅支持填写supabase_db。	postgresql://root:xxx@10.0.0.0:5432/supabase_db	请注意，如果数据库实例的登录密码包含特殊字符，必须使用URLEncode编码，如'@'编码为'%40'，否则功能不可用。

8. 命令行窗口输入如下命令，查看Supabase MCP是否已正常连接。

   claude mcp get supabase

   图5 RDS Supabase MCP的连接状态检查
   

9. RDS Supabase MCP工具配置完成后，您可以在Claude的对话框中，通过自然语言去访问、操作及管理Supabase应用及其托管的数据库服务。
   • 查询Supabase项目基础信息（MCP对接中未配置数据库实例的直连信息）

     交互输入以下信息：

     查询Supabase项目基础信息

     Agent回复如下：

     图6 Agent回复
     
   • 查询PostgreSQL实例当前库表信息（MCP对接中已配置数据库实例的直连信息）

     交互输入以下信息：

     查询Supabase当前业务库表概览

     Agent回复如下：

     图7 Agent回复
     

以下步骤介绍公网环境下如何通过CodeArts Agent对接并使用Supabase MCP。

1. 参考查看API Key，获取API Key，包含Anon Key和Service Role Key。
   图8 Supabase应用API Key列表
   

2. 参考绑定和解绑DNAT网关地址，绑定DNAT网关，并获取绑定的EIP和访问端口。
   图9 Supabase应用详情页面
   

3. 在Supabase应用详情页，单击托管实例名称，进入实例详情页。
4. 在左侧导航栏，选择“连接管理”，参考绑定和解绑弹性公网IP，为托管的数据库实例绑定EIP。
   图10 托管数据库实例连接信息
   

   如上图所示，获取实例的公网访问IP和端口号。

5. 本地安装Bun工具，请确保您的网络正常，可正常访问互联网资源。

   Bun工具是一款快速、现代的一体化JavaScript、TypeScript与JSX工具包，用于部署Supabase MCP Server。

   • Linux & MacOS

     curl -fsSL https://bun.sh/install | bash

   • Windows

     powershell -c "irm bun.sh/install.ps1 | iex"

6. 下载Supabase MCP Server开源项目源码到本地目录，并通过Bun来安装相关依赖。
   执行前请再次检查，确保已安装Git工具。详细安装操作，请参见Git官网。

   git clone https://github.com/HenkDz/selfhosted-supabase-mcp.git
   cd selfhosted-supabase-mcp
   bun install

7. 打开本地CodeArts Agent IDE，选择“设置 > MCP工具 > 配置MCP”，进入MCP配置文件（mcp_settings.json）编辑页面。
   在mcpServers中添加Supabase MCP Server相关配置，模板如下所示。

   {
       "mcpServers": {
           "selfhosted-supabase": {
               "command": "bun", 
               "args": [
                   "run", 
                   "<path-to-mcp-code-dist>/selfhosted-supabase-mcp/src/index.ts", 
                   "--url", 
                   "<your-supabase-url>", 
                   "--anon-key", 
                   "<your-anon-key>", 
                   "--service-key", 
                   "<your-service-role-key>", 
                   "--db-url", 
                   "<your-db-url>"
               ]
           }
       }
   }

   配置参数填写说明如表12，请结合实际的应用和托管实例相关配置信息，进行正确填写，替换掉<xxx>的整个内容（包含<和>符号）。

   表12 Supabase MCP对接配置参数填写规则

   参数项	是否必填	取值说明	取值示例	注意事项
   <path-to-mcp-code-dist>	是	填写本地下载的Supabase源码的根目录。	D:/workspace/rds-supabase/mcp/	确保其目录下已下载selfhosted-supabase-mcp git项目，文件夹存在。
   <your-supabase-url>	是	填写Supabase应用的公网访问地址。格式为： 已开启SSL：http(s)://Supabase应用的EIP:Supabase应用的访问端口 未开启SSL：http://Supabase应用的EIP:Supabase应用的访问端口	http://10.0.0.0:8443	确保本地能访问该IP地址。
   <your-anon-key>	是	填写Supabase应用的Anon Key。	**********	如果Anon Key进行了重置操作，请填写最新生效的API Key的取值。
   <your-service-role-key>	否	填写Supabase应用的Service Role Key。	**********	如果Service Role Key进行了重置操作，请填写最新生效的API Key的取值。
   <your-db-url>	否	填写Supabase应用托管的PostgreSQL数据库实例的直连地址。 格式为： postgresql://root:<登录密码>@<实例EIP>:<实例访问端口>/<数据库名称> <登录密码>：填写托管的数据库实例root账号的密码。 <实例EIP>：填写托管的数据实例的EIP。 <实例访问端口>：填写托管的数据实例的访问端口，一般默认为5432。 <数据库名称>：填写实例上Database的名称，当前仅支持填写supabase_db。	postgresql://root:xxx@10.83.34.105:5432/supabase_db	请注意，如果数据库实例的登录密码包含特殊字符，必须使用URLEncode编码，如'@'编码为'%40'，否则功能不可用。

8. 配置完成后，返回MCP工具页面。检查Supabase MCP连接状态和工具集信息。
   图11 CodeArts Agent 已安装MCP Server列表
   

9. 您可以在CodeArts Agent的对话框中，通过自然语言去访问、操作及管理Supabase应用及其托管的数据库服务。
   • 查询Supabase项目基础信息（MCP对接中已配置数据库实例的直连信息）

     交互输入以下信息：

     查询Supabase项目基础信息

     Agent回复如下：

     图12 Agent回复
     
   • 查询PostgreSQL实例当前库表信息（MCP对接中已配置数据库实例的直连信息）

     交互输入以下信息：

     查询Supabase当前业务库表概览

     Agent回复如下：

     图13 Agent回复