快速开始

模型上下文协议(MCP)

使用MCP将您的AI工具连接到Supabase

模型上下文协议 (Model Context Protocol, MCP) 是连接大型语言模型(LLMs)与Supabase等平台的标准。本指南介绍如何通过MCP将Supabase连接到以下AI工具：

连接后，您的AI助手可以代表您与Supabase项目进行交互和查询。

第一步：创建个人访问令牌(PAT)

首先，前往您的Supabase设置并创建个人访问令牌。为其命名以描述用途，例如"Cursor MCP服务器"。这将用于验证MCP服务器与您的Supabase账户。

第二步：在AI工具中配置

兼容MCP的工具可以使用Supabase MCP服务器连接到Supabase。以下是使用流行AI工具连接该服务器的说明：

Cursor

  1. 打开Cursor，如果项目根目录下不存在.cursor目录，请创建它。

  2. 如果不存在.cursor/mcp.json文件，请创建并打开它。

  3. 添加以下配置：

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    {  "mcpServers": {    "supabase": {      "command": "npx",      "args": [        "-y",        "@supabase/mcp-server-supabase@latest",        "--access-token",        "<个人访问令牌>"      ]    }  }}

    将 <个人访问令牌> 替换为您的个人访问令牌。

  4. 保存配置文件。

  5. 打开Cursor并导航至设置/MCP。服务器成功连接后，您应该能看到绿色的活动状态指示。

Windsurf 冲浪板

  1. 打开 Windsurf 并导航至 Cascade 助手

  2. 点击锤子(MCP)图标，然后选择配置打开配置文件

  3. 添加以下配置：

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    {  "mcpServers": {    "supabase": {      "command": "npx",      "args": [        "-y",        "@supabase/mcp-server-supabase@latest",        "--access-token",        "<个人访问令牌>"      ]    }  }}

    将 <个人访问令牌> 替换为您的个人访问令牌。

  4. 保存配置文件并在 Cascade 助手中点击刷新重新加载

  5. 服务器成功连接后，您将看到绿色的活动状态指示

Visual Studio Code (Copilot)

  1. 打开 VS Code 并在项目根目录创建 .vscode 文件夹（如果不存在）

  2. 创建并打开 .vscode/mcp.json 文件（如果不存在）

  3. 添加以下配置：

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    {  "inputs": [    {      "type": "promptString",      "id": "supabase-access-token",      "description": "Supabase个人访问令牌",      "password": true    }  ],  "servers": {    "supabase": {      "command": "npx",      "args": ["-y", "@supabase/mcp-server-supabase@latest"],      "env": {        "SUPABASE_ACCESS_TOKEN": "${input:supabase-access-token}"      }    }  }}

  4. 保存配置文件

  5. 打开 Copilot 聊天并切换到"Agent"模式。您会看到一个工具图标，点击可确认 MCP 工具是否可用。开始使用服务器时，系统会提示您输入个人访问令牌，请输入之前创建的令牌

有关在 VS Code 中使用 MCP 的更多信息，请参阅 Copilot 文档

Cline

  1. 在 VS Code 中打开 Cline 扩展并点击 MCP Servers 图标

  2. 点击 Configure MCP Servers 打开配置文件

  3. 添加以下配置：

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    {  "mcpServers": {    "supabase": {      "command": "npx",      "args": [        "-y",        "@supabase/mcp-server-supabase@latest",        "--access-token",        "<个人访问令牌>"      ]    }  }}

    将 <个人访问令牌> 替换为您的个人访问令牌。

  4. 保存配置文件。Cline 应会自动重新加载配置

  5. 服务器成功连接后，您将看到绿色的活动状态指示

Claude 桌面版

  1. 打开 Claude 桌面版并导航至设置

  2. 在开发者选项卡下，点击编辑配置以打开配置文件

  3. 添加以下配置：

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    {  "mcpServers": {    "supabase": {      "command": "npx",      "args": [        "-y",        "@supabase/mcp-server-supabase@latest",        "--access-token",        "<个人访问令牌>"      ]    }  }}

    将 <个人访问令牌> 替换为您的个人访问令牌。

  4. 保存配置文件并重启 Claude 桌面版

  5. 在新聊天界面中，您应该能看到一个锤子(MCP)图标，表示新的 MCP 服务器已可用

Claude 代码版

  1. 在项目根目录下创建 .mcp.json 文件（如果不存在）

  2. 添加以下配置：

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    {  "mcpServers": {    "supabase": {      "command": "npx",      "args": [        "-y",        "@supabase/mcp-server-supabase@latest",        "--access-token",        "<个人访问令牌>"      ]    }  }}

    将 <个人访问令牌> 替换为您的个人访问令牌。

  3. 保存配置文件

  4. 重启 Claude 代码版以应用新配置

后续步骤

您的 AI 工具现已通过 MCP 连接到 Supabase。尝试让 AI 助手创建新项目、创建表格或获取项目配置。

完整工具列表请参阅 GitHub README。如遇任何问题，请提交错误报告。

本地 Supabase 实例的 MCP 连接

Supabase MCP 服务器直接连接云平台以访问您的数据库。如果您运行的是本地 Supabase 实例，可以使用 Postgres MCP 服务器连接到本地数据库。此 MCP 服务器会以只读事务方式执行所有查询。

第一步：获取数据库连接字符串

要连接到本地 Supabase 实例，您需要获取本地数据库的连接字符串。可以通过运行以下命令查找连接字符串：

1
supabase status

如果使用 npx：

1
npx supabase status

这将输出本地 Supabase 实例的详细信息列表。请复制输出中的 DB URL 字段。

第二步：配置 MCP 服务器

使用以下配置设置您的客户端：

1
2
3
4
5
6
7
8
{  "mcpServers": {    "supabase": {      "command": "npx",      "args": ["-y", "@modelcontextprotocol/server-postgres", "<connection-string>"]    }  }}

将 <connection-string> 替换为您的连接字符串。

后续步骤

您的 AI 工具现已通过 MCP 连接到本地 Supabase 实例。尝试让 AI 工具使用自然语言命令查询您的数据库。