Query MCP (Supabase MCP Server)
2025.03.17
0
数据库管理开发工具数据库开发效率
Supabase MCP Server 是一个专为 Supabase 数据库设计的 MCP 服务器，旨在通过 MCP 协议为开发者提供安全、高效的数据库管理工具。它支持 SQL 查询执行、数据库管理、用户认证等功能，并内置了多层级的安全控制机制，适用于开发者在 IDE 中直接管理 Supabase 数据库。
View on GitHub
Overview
✨ 核心功能
- SQL 查询执行：支持安全执行 PostgreSQL 查询，包括读、写和破坏性操作，并内置风险评估。
- 数据库管理：提供数据库模式管理、表结构查看、数据迁移版本控制等功能。
- Supabase 管理 API：支持通过 Supabase 管理 API 进行项目管理和操作。
- 用户认证管理：通过 Supabase Auth Admin SDK 管理用户，支持创建、删除用户等操作。
- 日志与分析：提供对 Supabase 日志的访问和分析功能。
- 安全控制：内置三层级安全系统（安全、写、破坏性），确保操作的安全性。
🏆 适用场景
- 开发环境：在开发过程中直接通过 IDE 管理数据库，提高开发效率。
- 数据库管理：执行 SQL 查询、管理数据库结构和数据迁移。
- 用户管理：通过 Auth Admin SDK 管理用户，适用于需要频繁创建测试用户的场景。
- 日志分析：访问和分析 Supabase 日志，便于调试和监控。
🛠️ 工具列表
- 数据库查询工具：
get_schemas,get_tables,execute_postgresql等，用于执行和管理 SQL 查询。 - 管理 API 工具：
send_management_api_request,get_management_api_spec等，用于管理 Supabase 项目。 - 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检查是否正常工作。 - 查看日志：日志文件位于
~/.local/share/supabase-mcp/mcp_server.log（macOS/Linux）或%USERPROFILE%\.local\share\supabase-mcp\mcp_server.log（Windows）。 - MCP Inspector：使用
supabase-mcp-inspector调试服务器问题。