将Supabase连接到AI助手的配置指南

技术背景

Model Context Protocol (MCP) 对大语言模型（LLMs）与外部服务（如Supabase）的通信方式进行了标准化。supabase-mcp 项目可以将AI助手直接连接到Supabase项目，使其能够执行管理表、获取配置和查询数据等任务。

实现步骤

前提条件

需要在机器上安装 Node.js，可以通过以下命令检查：

node -v

如果未安装，可以从 nodejs.org 下载。

配置步骤

1. 创建个人访问令牌（PAT）：
   首先，进入 Supabase 设置，创建一个个人访问令牌，为其命名以描述其用途，如 “Cursor MCP Server”。此令牌用于对 MCP 服务器与 Supabase 账户进行身份验证，创建后需复制该令牌，因为之后将无法再次查看。
2. 配置 MCP 客户端：
   大多数 MCP 客户端以 JSON 格式存储配置，示例如下：

{
  "mcpServers": {
    "supabase": {
      "command": "npx",
      "args": [
        "-y",
        "@supabase/mcp-server-supabase@latest",
        "--access-token",
        "<personal-access-token>"
      ]
    }
  }
}

将 <personal-access-token> 替换为步骤 1 中创建的令牌。也可以省略 --access-token，而是将 SUPABASE_ACCESS_TOKEN 环境变量设置为个人访问令牌（设置后需要重启 MCP 客户端），这样在将配置提交到存储库时可以避免令牌被版本控制。

Windows 系统配置

如果在 Windows 系统上，需要为命令添加前缀：

{
  "mcpServers": {
    "supabase": {
      "command": "cmd",
      "args": [
        "/c",
        "npx",
        "-y",
        "@supabase/mcp-server-supabase@latest",
        "--access-token",
        "<personal-access-token>"
      ]
    }
  }
}

或者，如果在 WSL 中运行 Node.js，则使用：

{
  "mcpServers": {
    "supabase": {
      "command": "wsl",
      "args": [
        "npx",
        "-y",
        "@supabase/mcp-server-supabase@latest",
        "--access-token",
        "<personal-access-token>"
      ]
    }
  }
}

确保 Node.js 在系统的 PATH 环境变量中可用。可以通过以下命令设置：

# 获取 npm 路径
npm config get prefix
# 将目录添加到 PATH
setx PATH "%PATH%;<path-to-dir>"

最后重启 MCP 客户端。

只读模式

如果希望将 Supabase MCP 服务器限制为只读查询，可以在 CLI 命令中设置 --read-only 标志：

npx -y @supabase/mcp-server-supabase@latest --access-token=<personal-access-token> --read-only

此标志仅适用于数据库工具（execute_sql 和 apply_migration），不适用于其他工具，如 create_project 或 create_branch。

可用工具

该服务器提供了一系列工具供 LLM 使用，包括项目管理、数据库操作、边缘函数管理、项目配置、分支管理、开发工具和成本确认等功能。例如：

• 项目管理：list_projects、get_project、create_project 等。
• 数据库操作：list_tables、list_extensions、apply_migration 等。
• 边缘函数管理：list_edge_functions、deploy_edge_function。

常见问题

1. 令牌丢失怎么办：如果不小心丢失了个人访问令牌，需要在 Supabase 设置中重新创建一个新的令牌，并更新 MCP 客户端的配置。
2. Windows 系统命令执行问题：如果在 Windows 系统上执行命令时遇到问题，确保 Node.js 已正确安装并添加到系统的 PATH 环境变量中。
3. 只读模式限制：要注意 --read-only 标志仅限制数据库的写操作，对其他工具无效。