mcp

让 AI 助手直接查改 Supabase 数据库

开源 🏷️基础免费，高级付费 ⏳ 访问状态待核验智能体 🍴 复刻 421 🐛 待处理 133 👀 关注 26

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 2966

维护状态活跃

是否开源开源

定价模式 🏷️基础免费，高级付费支持限时试用 · Supabase 免费版可用，付费套餐按需升级，MCP 服务随平台提供

项目数据

分类智能体

开发团队supabase

官网地址https://supabase.com/mcp

GitHubhttps://github.com/supabase/mcp

定价模式🏷️基础免费，高级付费

价格说明Supabase 免费版可用，付费套餐按需升级，MCP 服务随平台提供

访问状态⏳ 访问状态待核验

是否开源是

开源协议Apache-2.0

主要语言TypeScript

GitHub 星标★ 2966

上线时间2024-12-20 00:00:00

代码更新2026-10-21

仓库体积4.3 MB

本站数据更新2026-10-22

维护状态活跃

收录时间2026-10-22

浏览次数0

项目介绍

Supabase MCP 是 Supabase 官方提供的模型上下文协议服务器，用于把 Supabase 项目接入 Claude、Cursor 等支持 MCP 的 AI 助手。它解决的是 AI 助手无法直接感知和操作数据库上下文的问题：通过标准化的 MCP 工具，AI 可以在对话中查询表结构、执行 SQL、管理项目配置、查看日志等，而不必手动复制粘贴 schema 或切换控制台。核心能力包括数据库查询与 SQL 执行、表结构探索、项目与分支管理、边缘函数和存储等资源的操作入口，并支持按项目范围授权，降低误操作风险。项目用 TypeScript 实现，可通过 npx 快速启动，配置到客户端的 MCP 设置中即可使用，适合希望让 AI 深度参与 Supabase 开发流程的团队。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-10-22 · 当前星标 ★ 2966

使用教程

ℹ 本教程由 AI 依据该项目 README 整理，个别步骤可能需要按你的环境微调。

难度：入门约 10 分钟部署方式：云服务 6 步

环境要求

一个已创建的 Supabase 项目，并知道它所属的组织
支持 MCP 的 AI 客户端（如 Cursor、Claude、Windsurf）
能访问 Supabase Dashboard 与 https://mcp.supabase.com/mcp 的网络环境
可选：使用 Vercel AI SDK 的 TypeScript 项目（用于 createToolSchemas 集成）

安装与启动步骤

1阅读安全最佳实践

官方建议先了解把 LLM 接入 Supabase 项目的安全风险与缓解手段，再决定是否接入。
2获取 MCP 连接地址

在 Supabase Dashboard 的 MCP connection 标签页生成项目专属 MCP URL，或使用通用地址。
3配置 MCP 客户端

在客户端的 MCP 配置中加入 supabase 服务器，传输类型为 http，工具由服务端提供。
```
{
  "mcpServers": {
    "supabase": {
      "type": "http",
      "url": "https://mcp.supabase.com/mcp"
    }
  }
}
```
4登录并选择组织

保存配置后客户端会自动提示登录 Supabase，务必选择包含目标项目的那个组织。
5按需收紧访问范围

在 URL 上追加参数：限定单个项目、只读模式、只开放指定功能组，降低误操作风险。
```
https://mcp.supabase.com/mcp?project_ref=abcdefghijklmnop&read_only=true&features=database,docs
```
6可选：接入 AI SDK

TypeScript 项目可调用 createToolSchemas() 把 Supabase 工具当作静态工具，带输入输出类型。

关键配置

配置项	必填	说明	示例
`mcpServers.supabase.type`	是	MCP 传输类型，README 中为 http（托管远程服务）	`http`
`mcpServers.supabase.url`	是	MCP 服务器地址，可拼接查询参数做范围限制	`https://mcp.supabase.com/mcp`
`project_ref`	否	URL 参数，把服务限定到单个 Supabase 项目	`abcdefghijklmnop`
`read_only`	否	URL 参数，为 true 时排除所有会修改数据的工具	`true`
`features`	否	URL 参数，限定开放的功能组，默认开启全部默认组	`database,docs`
`createToolSchemas 选项`	否	可传 features、projectScoped、readOnly，需与服务端 URL 参数保持一致	`{ features: ['database','docs'], projectScoped: true, readOn`