Supabase MCP Server

🚀 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 服務器的高風險操作確認界面和查詢結果查看界面。