Supabase MCP Server

Supabase MCP Server

简介

Supabase MCP Server 是由 Supabase 官方推出的 Model Context Protocol（MCP）服务器，用于将 Supabase 项目连接到 AI 助手（Cursor、Claude、Windsurf 等主流工具），让 AI 直接操作用户的数据库、项目配置和边缘函数等资源。

核心能力

• 数据库直连操作：AI 可直接查看数据表结构（listTables、queryTableData、getTableSchema），无需手动编写 SQL 也能了解表设计
• 项目配置管理：获取项目环境变量、连接字符串、边缘函数列表等后台信息
• 边缘函数调用：通过 AI 触发 Supabase Edge Functions 并获取执行结果
• 实时分析查询：在 AI 辅助下执行 PostgREST 和 GoTrue API 操作
• 文档智能检索：连接 Supabase 官方文档，帮助开发者快速查找 API 用法
• 存储桶管理：查询和管理 Supabase Storage 中的文件资源
• 多客户端兼容：支持 Cursor、Claude Desktop、Windsurf 等所有兼容 MCP 协议的 AI 工具
• OAuth 安全认证：通过 Supabase 账号 OAuth 登录，无需手动管理 API Key

安装配置

方式一：HTTP 模式（推荐，最简）

在 AI 助手的 MCP 配置文件中添加以下内容：

{
  "mcpServers": {
    "supabase": {
      "type": "http",
      "url": "https://mcp.supabase.com/mcp"
    }
  }
}

AI 工具会在首次使用时引导你登录 Supabase 账号完成授权。

方式二：本地开发（Supabase CLI）

本地开发环境通过 Supabase CLI 启动：

supabase start
# MCP Server 在 http://localhost:54321/mcp 可用

这种方式提供完整工具集，适合本地调试。

方式三：自托管部署

使用 Docker 部署自托管 Supabase 实例时，参考官方文档启用 MCP 服务器，支持完整的 OAuth 认证体系。

使用步骤

1. 配置 AI 客户端：在 Cursor/Claude Desktop/Windsurf 等工具中添加上述 MCP 服务器配置
2. 完成 Supabase 登录授权：首次使用时会跳转 Supabase OAuth 授权页面
3. 向 AI 描述需求：如"查看我的 users 表有哪些字段"或"执行一条查询用户总数的 SQL"
4. AI 读取工具结果并响应：MCP 服务器返回结构化数据，AI 整理后呈现给你
5. 进一步操作：可继续让 AI 基于返回结果执行增删改查等后续操作

适用场景

• 数据库探索与学习：刚接手一个 Supabase 项目，想快速了解表结构、字段类型和关系
• AI 辅助后端开发：在编码过程中让 AI 直接读写数据库，辅助写 CRUD 接口
• 自动化运维：通过自然语言定期查询数据统计、监控边缘函数执行情况
• 文档速查：在开发环境中随时问 AI"这个 API 怎么用"，无需跳转浏览器

适用人群

• 后端开发者：使用 Supabase 作为 BaaS 平台的全栈工程师
• 数据分析师：需要频繁查询 Supabase 数据，但不想每次都打开 Dashboard
• AI 应用开发者：构建基于 Supabase + AI 的应用，需要让 AI 读写用户数据
• 初学者：想通过自然语言探索 Supabase 项目结构，降低学习门槛

工作原理

Supabase MCP Server 基于 Anthropic 提出的 Model Context Protocol 标准工作。服务器以 HTTP 接口形式托管在 https://mcp.supabase.com/mcp，AI 客户端通过标准 MCP 协议调用服务器暴露的工具（Tools）。每个工具对应一个 Supabase API 端点或 CLI 命令，服务器负责转换请求、注入认证令牌并返回结构化结果。对于生产环境，强烈建议配置 read_only=true 参数限制 AI 的写操作权限，防止误删数据。

官方链接

• GitHub：https://github.com/supabase/mcp
• 官方文档：https://supabase.com/docs/guides/getting-started/mcp
• MCP 连接地址：https://supabase.com/dashboard/project/_/?showConnect=true&connectTab=mcp
• npm 包：https://www.npmjs.com/package/@supabase/mcp-server-supabase