🚀 Supabase MCP 服务器

Supabase MCP（管理控制台）服务器是一款强大的工具，可用于管理和操作 Supabase 数据库。它具备多种功能，如通过 SQL 执行查询、集成 Supabase 管理 API、实现自动版本控制以及进行安全管理等，旨在简化数据库和相关服务的管理流程。

🚀 快速开始

Supabase MCP 服务器能帮助你轻松管理 Supabase 数据库。你可以通过 SQL 执行各类查询，还能借助集成的管理 API 对数据库资源进行操作。以下将为你介绍安装和使用的基本步骤。

✨ 主要特性

PostgreSQL 查询执行

• 直接 SQL 执行：支持运行任意 PostgreSQL 查询，涵盖 SELECT、INSERT、UPDATE、DELETE 等。
• 事务处理：支持原子交易，确保操作要么完全成功，要么完全失败。
• 结果查看：提供直观的结果展示，支持 JSON 格式输出和自定义列格式化。

Supabase 管理 API 集成

• 资源管理：可直接创建、删除或修改数据库对象（表、列、索引）。
• 权限管理：能轻松配置用户和角色的访问权限。
• 备份与恢复：可执行手动或自动数据备份，并从备份中恢复。

安全模式

• 风险分类：所有操作按风险等级分为：
  • 低风险：仅读取数据（SELECT 查询、GET API 请求）。
  • 中等风险：修改数据但不修改结构（INSERT/UPDATE/DELETE、大多数 POST/PUT API 请求）。
  • 高风险：修改数据库结构或可能导致数据丢失的操作（DROP/TRUNCATE、 DELETE API 端点）。
  • 极高风险：具有严重后果的操作，完全被阻止（删除项目）。

自动版本控制

• 迁移脚本生成：所有对数据库的写入和破坏性 SQL 操作都会自动生成迁移脚本。
• 确认流程：在 unsafe 模式下，所有高风险操作都需要用户明确批准才能执行。

日志与审计

• 查询记录：记录所有执行的查询及其结果。
• 审计追踪：提供详细的日志信息，便于跟踪和审查操作历史。

📦 安装指南

通过包管理器安装

pip install supabase-mcp-server

手动安装

下载源代码并运行：

git clone https://github.com/alexander-zuev/supabase-mcp-server.git
cd supabase-mcp-server
python setup.py install

💻 使用示例

基础用法

连接数据库

使用默认凭据或自定义配置连接你的 Supabase 数据库。

执行查询

运行任意 PostgreSQL 查询：

SELECT * FROM users;

高级用法

管理 API 调用

通过 MCP 服务器提供的 API 方法管理数据库资源。

🔧 技术细节

安全模式

所有操作按风险等级进行分类，不同风险等级的操作有不同的处理方式。低风险操作仅读取数据，可直接执行；中等风险操作修改数据但不修改结构；高风险操作修改数据库结构或可能导致数据丢失，在 unsafe 模式下需要用户明确批准；极高风险操作具有严重后果，会被完全阻止。

自动版本控制

所有对数据库的写入和破坏性 SQL 操作都会自动生成迁移脚本，确保数据库的变更可追溯和可恢复。在 unsafe 模式下，高风险操作的确认流程增加了操作的安全性。

日志与审计

查询记录功能记录所有执行的查询及其结果，审计追踪功能提供详细的日志信息，便于跟踪和审查操作历史，有助于发现和解决潜在的问题。

📚 详细文档

变更记录

v1.0.0

• 初始版本发布，包含基本的 SQL 执行和 API 管理功能。
• 引入了安全模式和事务支持。

v2.0.0

• 新增自动版本控制功能。
• 支持高风险操作确认流程。
• 优化日志记录和审计功能。

v3.0.0

• 增强安全性，修复若干安全漏洞。
• 改进性能监控和资源管理。

附图

附图展示了 MCP 服务器的高风险操作确认界面和查询结果查看界面。