Query MCP (Supabase MCP Server)

基本能力

产品定位

Supabase MCP Server 是一个为 Supabase 数据库提供安全 SQL 查询执行、数据库管理和用户认证的工具。它支持多种 MCP 客户端，提供丰富的功能和安全控制，适用于开发者在 IDE 中直接管理和操作 Supabase 数据库。

核心功能

• SQL 查询执行：支持安全执行 PostgreSQL 查询，包括读、写和破坏性操作。
• 安全管理：提供三层次的安全控制（安全、写、破坏性），确保操作的安全性。
• 数据库管理：支持自动版本控制、事务处理和连接池管理。
• Supabase 管理 API：提供对 Supabase 管理 API 的访问，支持项目管理和用户认证。
• 日志和监控：支持访问 Supabase 日志和监控数据，便于调试和性能分析。

适用场景

• 开发环境：在 IDE 中直接管理和操作 Supabase 数据库。
• 数据库管理：执行 SQL 查询、管理数据库结构和数据。
• 用户认证：通过 Auth Admin SDK 管理用户和认证流程。
• 日志分析：访问和分析 Supabase 日志，便于调试和监控。

工具列表

• 数据库查询工具：get_schemas, get_tables, execute_postgresql, confirm_destructive_operation 等。
• 管理 API 工具：send_management_api_request, get_management_api_spec 等。
• Auth Admin 工具：get_auth_admin_methods_spec, call_auth_admin_method 等。
• 日志工具：retrieve_logs。

常见问题解答

• 安装问题：确保 Python 3.12+ 和 uv 或 pipx 已安装。
• 配置问题：正确设置环境变量或全局配置文件。
• 连接问题：检查 Supabase 项目引用和区域设置是否正确。
• 工具不可用：确保使用完整路径配置 MCP 服务器。

使用教程

使用依赖

• Python 3.12+：确保系统已安装 Python 3.12 或更高版本。
• uv 或 pipx：推荐使用 uv 或 pipx 进行安装。

安装教程

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

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

调试方式

# 直接运行服务器以检查安装
supabase-mcp-server

# 查看日志
cat ~/.local/share/supabase-mcp/mcp_server.log

许可证

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