Supabase MCP

Overview

Supabase MCP 是一个模型上下文协议服务器，允许 AI 代理与 Supabase 进行交互。Supabase 是一个开源的 Firebase 替代方案，提供 PostgreSQL 数据库、身份验证、存储、实时订阅和边缘函数。通过此 MCP 服务器，AI 可以执行 SQL 查询、管理表结构、处理身份验证和实时数据订阅。

Supabase MCP 使得 AI 代理能够直接操作完整的后端服务，自动进行数据管理、用户管理和实时应用开发。它特别适合全栈开发、快速原型和后端自动化。

Features

数据库操作：执行 SQL 查询、CRUD 操作
表管理：创建、修改、删除表
身份验证：管理用户、会话、角色
存储操作：上传、下载、管理文件
实时订阅：监听数据库变化
边缘函数：调用和部署边缘函数
API 生成：自动生成 REST/GraphQL API

Installation

# 使用 npx 运行
npx -y @modelcontextprotocol/server-supabase

# 或使用 uvx
uvx mcp-server-supabase

Configuration

添加以下配置到 claude_desktop_config.json：

{
  "mcpServers": {
    "supabase": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-supabase"],
      "env": {
        "SUPABASE_URL": "https://your-project.supabase.co",
        "SUPABASE_ANON_KEY": "your-anon-key",
        "SUPABASE_SERVICE_ROLE_KEY": "your-service-role-key"
      }
    }
  }
}

Available Tools

Tool	Description
`supabase_list_tables`	列出所有表
`supabase_describe_table`	获取表结构
`supabase_query`	执行 SQL 查询
`supabase_insert`	插入数据
`supabase_update`	更新数据
`supabase_delete`	删除数据
`supabase_list_users`	列出认证用户
`supabase_upload_file`	上传文件到存储
`supabase_subscribe`	订阅实时变化

Usage Examples

示例 1：数据查询

AI: 查询 users 表中所有活跃用户

Supabase MCP:
- 调用 supabase_query
- SQL: SELECT * FROM users WHERE status = 'active'
- 返回用户列表

示例 2：用户管理

AI: 创建一个新用户并分配角色

Supabase MCP:
- 调用 supabase_insert（auth.users）
- 设置 email, password, role
- 返回创建的用户信息

示例 3：实时订阅

AI: 监听 orders 表的新订单

Supabase MCP:
- 调用 supabase_subscribe
- 监听 orders 表的 INSERT 事件
- 新订单到达时通知

Pros

✅ 完整的 Supabase 功能覆盖
✅ PostgreSQL 全功能
✅ 内置身份验证
✅ 实时订阅支持
✅ 开源免费客户端
✅ 适合全栈开发

Cons

❌ 需要 Supabase 项目
❌ 配置较复杂（多个凭证）
❌ 某些功能需要付费计划
❌ 需要 PostgreSQL 知识

When to Use

需要 AI 辅助全栈开发时
想要自动化后端操作时
需要实时数据时
想要快速原型时
需要身份验证管理时

Supabase MCP

Overview

Setup

Configuration

Documentation

Supabase MCP

Overview

Features

Installation

Configuration

Available Tools

Usage Examples

示例 1：数据查询

示例 2：用户管理

示例 3：实时订阅

Pros

Cons

When to Use

Resources