Supabase MCP Server

基本能力

产品定位

Supabase MCP Server 是一个专为 Supabase 数据库设计的 MCP 服务器，旨在通过标准化的 MCP 协议为开发工具提供安全、高效的数据库交互能力。

核心功能

• 数据库查询工具：支持 SELECT、INSERT、UPDATE、DELETE 等 SQL 操作，包括事务处理
• 管理 API 工具：提供对 Supabase 管理 API 的安全访问
• Auth Admin 工具：支持通过 Python SDK 调用 Supabase 认证管理方法
• 安全控制：提供只读/读写模式切换、操作安全分级等安全特性
• 多环境支持：兼容本地和远程 Supabase 实例

适用场景

• 在开发工具中安全地执行数据库操作
• 自动化 Supabase 项目管理任务
• 创建和管理测试用户
• 执行数据库迁移和架构变更

工具列表

1. 数据库工具
2. get_db_schemas：获取数据库模式列表
3. get_tables：获取指定模式中的表信息
4. get_table_schema：获取表结构详情

5. execute_sql_query：执行原始 SQL 查询

6. 管理 API 工具

7. send_management_api_request：发送管理 API 请求
8. get_management_api_spec：获取 API 规范
9. get_management_api_safety_rules：获取安全规则

10. live_dangerously：切换安全模式

11. Auth Admin 工具

12. get_auth_admin_methods_spec：获取认证方法文档
13. call_auth_admin_method：调用认证管理方法

常见问题解答

• 安装问题：确保已安装 PostgreSQL 开发库
• 连接问题：检查环境变量配置
• 权限问题：确保数据库角色有足够权限
• 日志查看：日志存储在用户目录的 .local/share/supabase-mcp 下

使用教程

使用依赖

1. Python 3.12+
2. PostgreSQL 16+

MacOS 安装 PostgreSQL

brew install postgresql@16

Windows 安装 PostgreSQL 从 https://www.postgresql.org/download/windows/ 下载安装

安装教程

推荐使用 pipx 安装

pipx install supabase-mcp-server

使用 uv 安装

uv pip install supabase-mcp-server

从源码安装

uv venv
source .venv/bin/activate  # Mac/Linux
.venv\Scripts\activate  # Windows
uv pip install -e .

调试方式

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

supabase-mcp-server

1. 查看日志

# Mac/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 了解完整条款。