Medieage Supabase MCP Server

🚀 Supabase MCP 服務器

Supabase MCP（管理控制檯）服務器是一款強大的工具，可助力用戶管理和操作 Supabase 數據庫及相關服務。它具備執行 SQL 查詢、訪問 Supabase 管理 API、查看日誌以及自動記錄數據庫變更版本等功能，能有效提升數據庫管理的效率與安全性。

🚀 快速開始

Supabase MCP 服務器為用戶管理 Supabase 數據庫和相關服務提供了便利。它提供了豐富的功能，能滿足不同場景下的數據庫管理需求。

✨ 主要特性

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 服務器功能全面，能幫助用戶高效管理數據庫和相關服務。通過安全模式和遷移腳本生成等功能，極大地提升了操作的安全性和可追溯性，無論是開發人員還是運維工程師，都能從中受益。

以上是該項目的完整介紹，希望對您有所幫助！