Supabase MCP 服务器

介绍

Supabase MCP（管理控制台）服务器是一个功能强大的工具，旨在帮助用户管理和操作其 Supabase 数据库和相关服务。它提供了多种功能，包括执行 SQL 查询、访问 Supabase 管理 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 操作都会自动生成相应的迁移文件。
• 版本控制集成：将数据库变更记录到版本控制系统中，便于追踪和管理。

版本更新

以下是 MCP 服务器的主要版本更新日志：

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 服务器是一个功能全面的工具，能够帮助用户高效管理其数据库和相关服务。通过安全模式和迁移脚本生成等功能，它极大地提升了操作的安全性和可追溯性。无论是开发人员还是运维工程师，都可以从中受益。

以上是该项目的完整介绍，希望对您有所帮助！