Medieage Supabase MCP Server

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

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