Supabase MCP Server

基本能力

产品定位

Supabase MCP Server 是一个为 MCP 客户端提供安全数据库交互和管理功能的中间件服务，特别针对 Supabase 数据库设计。

核心功能

• 数据库查询工具：
• 支持安全执行 PostgreSQL 查询（带风险评估）
• 三级安全系统：safe（只读）、write（数据修改）、destructive（结构修改）
• 自动迁移版本控制

• 提供 schema/table 查询、表结构获取等工具

• 管理 API 工具：

• 安全访问 Supabase 管理 API
• 自动注入项目引用

• 提供 API 规范和安全规则查询

• Auth Admin 工具：

• 直接调用 Supabase Auth Admin 方法

• 支持用户管理、邀请、链接生成等

• 通用安全系统：

• 统一的风险等级分类（低/中/高/极高）
• 高风险操作需要显式确认

适用场景

• 在 IDE 中安全地管理 Supabase 数据库
• 自动化执行数据库迁移和变更
• 通过客户端工具管理 Supabase 项目和用户认证
• 开发需要与 Supabase 深度集成的应用

工具列表

1. 数据库工具：
2. get_schemas：列出所有 schema
3. get_tables：列出所有表和视图
4. get_table_schema：获取表结构详情
5. execute_postgresql：执行 SQL 查询

6. confirm_destructive_operation：确认执行高风险操作

7. 管理 API 工具：

8. send_management_api_request：发送管理 API 请求

9. get_management_api_spec：获取 API 规范

10. Auth Admin 工具：

11. get_auth_admin_methods_spec：获取 Auth 方法文档
12. call_auth_admin_method：调用 Auth 方法

常见问题解答

• 安装问题：确保使用 Python 3.12+ 和正确的包管理器（推荐 pipx）
• 连接问题：检查环境变量配置和项目引用是否正确
• 工具不可见：可能需要使用完整路径配置客户端
• 日志查看：日志位于用户目录的 .local/share/supabase-mcp/ 下

使用教程

使用依赖

• Python 3.12+
• 可选：uv 包管理器（推荐）

# 安装 Python 3.12+
# MacOS
brew install [email protected]

# 安装 uv
curl -LsSf https://astral.sh/uv/install.sh | sh

安装教程

# 使用 pipx 安装（推荐）
pipx install supabase-mcp-server

# 使用 uv 安装
uv pip install supabase-mcp-server

# 从源码安装
uv venv
source .venv/bin/activate  # MacOS/Linux
.venv\Scripts\activate      # Windows
uv pip install -e .

调试方式

1. 直接运行服务器检查是否正常工作：

supabase-mcp-server

1. 检查日志：

# MacOS/Linux
cat ~/.local/share/supabase-mcp/mcp_server.log

# Windows
Get-Content "$env:USERPROFILE\.local\share\supabase-mcp\mcp_server.log"

1. 使用 MCP Inspector 调试（源码安装）：

supabase-mcp-inspector

许可证

该项目遵循 Apache-2.0 开源许可条款，请参阅 Apache-2.0 了解完整条款。