← 返回目录
S

Supabase MCP Server

官方
将 Supabase 项目连接到 AI 助手
GitHub 源仓库 ↗
★ 2.9k Stars 分类 · 数据库 非常热门 源版本 70fee92d41c3
74FMRS · B
可靠性
10/20
安全与权限
15/20
维护活跃度
18/20
文档质量
17/20
安装易用性
14/20

官方服务器,功能丰富,但需注意权限和风险管理。

查看 FMRS 评分方法 →

Supabase MCP 服务器是一个官方 MCP 服务器,允许 AI 助手(如 Cursor、Claude、Windsurf)通过标准协议与 Supabase 平台交互。它提供了管理表、获取配置、查询数据等工具,支持远程托管和本地 CLI 环境。该服务器由 Supabase 维护,支持 OAuth 2.1(远程)和只读模式。

工具能力

暂未整理工具清单。

安装接入

  1. 阅读安全最佳实践。2. 在 MCP 客户端中配置服务器。对于远程服务器,使用 URL: https://mcp.supabase.com/mcp。对于本地 CLI,使用 http://localhost:54321/mcp。npm 包可通过 npx 运行,需要设置 SUPABASE_ACCESS_TOKEN 环境变量(个人访问令牌),并可选参数 --project-ref、--read-only 等。
claude_desktop_config.json
{
  "mcpServers": {
    "supabase": {
      "type": "http",
      "url": "https://mcp.supabase.com/mcp"
    }
  }
}

选型与风险

适合谁

  • 使用 Supabase 的开发者和团队
  • 希望将 AI 集成到数据库工作流的用户

不适合谁

  • 不使用 Supabase 的用户
  • 需要完全本地且无云依赖的场景(CLI 环境功能有限)

所需权限

  • 需要 Supabase 访问令牌(SUPABASE_ACCESS_TOKEN)
  • 可能要求 OAuth 2.1 授权(远程)
  • 默认具有读写权限,可启用只读模式(--read-only)

风险与副作用

  • LLM 可能执行破坏性操作,如删除表或数据
  • 令牌泄露可能导致未授权访问
  • 远程服务器可能记录请求,存在隐私风险

常见排障

  1. 检查访问令牌是否有效且未过期
  2. 确认项目引用 ID 正确
  3. 确保客户端支持 HTTP 传输
  4. 如果使用 CLI,检查本地服务器是否运行

使用场景

让 AI 助手管理 Supabase 表结构
通过自然语言查询数据库
获取项目配置和文档

支持客户端

Claude Desktop完整支持
Cursor完整支持
Windsurf完整支持