Supabase MCP 伺服器專案

MCP工具

Supabase MCP 伺服器專案

supabase-mcp 是由 Supabase 社群所開發的一個開源專案。它的核心目標是作為一個模型內容協定 (Model Context Protocol, MCP) 伺服器，專門用來將 Supabase 的強大後端服務無縫連接到各種 AI 助理（如 Cursor, Claude, Windsurf 等）。

這個專案讓開發者能夠直接透過自然語言對話，來管理和操作他們的 Supabase 專案，從而將繁瑣的後端管理任務轉化為與 AI 的簡單交談。

核心價值與運作方式

在傳統開發流程中，開發者需要透過 Supabase 的儀表板或 CLI 工具來查詢數據、修改資料庫結構或部署函式。supabase-mcp 將這一切徹底改變。

其運作方式如下：

1. 開發者在他們的 AI 助理（例如 Cursor 編輯器）中設定 supabase-mcp 伺服器。這通常只需要一個簡單的 npx 命令，並提供 Supabase 的個人存取權杖 (Personal Access Token)。
2. 設定完成後，開發者就可以開始用自然語言下達指令，例如：

   「幫我列出目前專案中的所有資料表。」
   「查詢 users 資料表中，過去 24 小時內註冊的所有使用者。」
   「幫我建立一個 SQL 遷移檔案，為 products 資料表新增一個 stock_count 欄位。」
   「根據我目前的資料庫結構，產生對應的 TypeScript 型別定義，並存成 types.ts 檔案。」

3. AI 助理會將這些指令轉換為對 supabase-mcp 伺服器所提供工具的呼叫。
4. 伺服器在後端與 Supabase API 進行通訊，執行實際的操作，並將結果回傳給 AI，最終呈現給開發者。

全面的工具集

supabase-mcp 提供了一套極其豐富的工具，幾乎涵蓋了 Supabase 的所有核心功能：

• 資料庫操作 (Database):

  • 執行原始 SQL 查詢 (execute_sql)。
  • 套用資料庫遷移 (apply_migration)。
  • 列出資料表、擴充功能和遷移歷史。

• 知識庫查詢 (Docs):

  • 能夠搜尋最新的 Supabase 官方文件，讓 AI 可以自主學習並回答關於 Supabase 功能的問題。

• 帳號與專案管理 (Account):

  • 列出、建立、暫停或還原專案（在未限定單一專案時）。
  • 管理組織與查詢費用。

• 開發與部署 (Development & Functions):

  • 獲取專案的 API URL 和金鑰。
  • 根據資料庫結構自動生成 TypeScript 型別。
  • 列出和部署 邊緣函式 (Edge Functions)。

• 分支管理 (Branching):

  • 支援建立、合併、重設資料庫的開發分支，實現安全的開發與測試流程。

• 除錯與監控 (Debug):

  • 獲取專案的服務日誌和安全建議。

強調安全性的設計

此專案特別強調在賦予 AI 強大能力的同時，必須確保安全性。因此，它提供了多層次的安控機制，並強烈建議使用者遵循最佳實踐：

• 唯讀模式 (--read-only): 強烈建議預設開啟，可防止 AI 執行任何寫入或修改資料庫的操作。
• 專案範圍限定 (--project-ref): 將伺服器的權限鎖定在單一專案，避免 AI 存取到其他無關的專案。
• 功能群組控制 (--features): 允許使用者精確地啟用或停用特定的工具組，最小化攻擊面。
• 開發環境優先: 官方建議將此工具用於開發環境，而非直接連接到儲存敏感資料的生產環境。

總結來說，supabase-mcp 是一個賦能開發者的強大工具。它將 Supabase 的後端即服務 (Backend as a Service) 能力與大型語言模型的自然語言理解能力完美結合，讓開發者能夠以前所未有的高效率，透過對話來建構、管理和維護他們的應用程式後端。

• MCP平台來源: github
• 連結: https://github.com/supabase-community/supabase-mcp?tab=readme-ov-file

立即試用MCP工具