🚀 Supabase MCP 服务器
Supabase MCP（管理控制台）服务器是一款强大的工具，可助力用户管理和操作 Supabase 数据库及相关服务。它具备执行 SQL 查询、访问 Supabase 管理 API、查看日志以及自动记录数据库变更版本等功能，能有效提升管理效率和操作安全性。
🚀 快速开始
Supabase MCP 服务器为用户高效管理 Supabase 数据库及相关服务提供了全面的解决方案。通过一系列强大功能，如执行 SQL 查询、访问管理 API、自动记录数据库变更版本等，极大地提升了操作的安全性和可追溯性。
✨ 主要特性
1. 执行 PostgreSQL 查询
execute_postgresql 工具支持用户直接向数据库发送 SQL 查询。为降低操作风险，该工具设有安全模式：
- 普通模式：仅允许执行读取操作（SELECT）。
- 写入模式：允许写入和破坏性操作，但需通过
live_dangerously工具进行显式确认。
自 v0.3.8 版本起，所有写入和破坏性 SQL 操作都会自动生成迁移脚本，并记录到版本控制系统中，方便用户跟踪和管理数据库变更。
2. 管理 API 访问
借助 MCP 服务器，用户可程序化地访问 Supabase 管理 API。所有 API 请求会进行风险分类：
- 低风险：仅为读取操作（如 GET 请求）。
- 中等风险：写入数据但不修改结构的操作（如 POST、PUT 请求）。
- 高风险：可能破坏数据库结构或导致数据丢失的操作（如 DELETE 端点）。
所有高风险操作需在启用 unsafe 模式后，经过显式确认方可执行。
3. 数据库迁移版本控制
从 v0.3.8 版本开始，MCP 服务器会为所有写入和破坏性 SQL 操作自动生成迁移脚本。这些脚本有助于用户跟踪数据库变更，确保版本控制系统中包含最新的数据库 schema。
4. 安全模式
自 v0.3.8 版本起，统一安全模式 应用于所有服务（包括数据库、API 和 SDK）。根据操作的风险级别，设置不同的控制策略：
- 低风险：始终允许执行。
- 中等风险：需启用
unsafe模式。 - 高风险：在启用
unsafe模式的同时，还需进行显式确认。 - 极高风险：完全禁止（如删除项目）。
5. 查询确认流程
所有高风险操作（包括数据库查询和 API 请求）即便启用了 unsafe 模式也会被阻止，用户必须进行显式批准后才能执行。
📚 详细文档
功能模块
数据库管理
- 基本 SQL 执行：支持 SELECT、INSERT、UPDATE 和 DELETE 操作。
- 事务处理：支持单次提交或回滚的事务。
- 连接池支持：兼容 pooled 和 direct 类型的数据库连接。
API 访问
- 资源管理：涵盖存储、实时通信（RTC）、边缘函数和计划任务等。
- 日志查询：提供按时间、文本搜索、字段过滤或自定义 SQL 查询的日志分析功能。
自动化与工具
- 迁移脚本生成：所有写入和破坏性 SQL 操作都会自动生成相应的迁移文件。
- 版本控制集成：将数据库变更记录到版本控制系统中，便于追踪和管理。
版本更新
v0.3.8 更新说明
- 引入统一安全模式，适用于所有操作类型。
- 实现高风险操作的显式确认机制。
- 开始自动生成迁移脚本，并记录到版本控制系统中。
v0.3.7 更新说明
- 提供对实时通信（RTC）和计划任务的日志查询功能。
- 优化事务处理逻辑，支持单次提交或回滚。
- 增强错误处理机制，提升整体稳定性。
💻 使用示例
基础用法
# 示例：执行 PostgreSQL 查询并生成迁移脚本
from supabase_mcp import MCPClient
client = MCPClient(unsafe_mode=True)
response = client.execute_postgresql("SELECT * FROM users", live_dangerously=True)
# 示例：访问 Supabase 管理 API
api_response = client.access_management_api(resource="storage", action="list_buckets")
# 示例：查看数据库日志
logs = client.get_logs(start_time="2023-10-01 00:00:00", end_time="2023-10-02 00:00:00")
🔚 结论
Supabase MCP 服务器功能全面，能帮助用户高效管理数据库和相关服务。通过安全模式和迁移脚本生成等功能，极大地提升了操作的安全性和可追溯性，无论是开发人员还是运维工程师都能从中受益。
以上是该项目的完整介绍，希望对您有所帮助！