Supabase MCP

🚀 Supabase MCP 服務器

Supabase MCP 服務器可將您的 Supabase 項目與 Cursor、Claude、Windsurf 等 AI 助手相連接，藉助模型上下文協議（MCP），標準化大型語言模型（LLMs）與 Supabase 等外部服務的通信，使 LLMs 能直接連接您的 Supabase 項目，執行項目管理、數據庫操作和代碼生成等操作。

🚀 快速開始

模型上下文協議 (MCP) 標準化了大型語言模型（LLMs）與外部服務（如 Supabase）之間的通信方式。它使 LLMs 能夠直接連接到您的 Supabase 項目，並執行各種操作，例如管理項目、執行數據庫操作和生成代碼。

✨ 主要特性

• 實現 Supabase 項目與多種 AI 助手的連接。
• 藉助 MCP 協議，讓 LLMs 可直接對 Supabase 項目進行操作。
• 提供豐富的工具集，涵蓋項目管理、數據庫操作、項目配置等多方面功能。

📦 安裝指南

先決條件

在開始之前，請確保您具備以下條件：

• 一個有效的 Supabase 賬戶。
• 安裝並配置了 Node.js 和 npm。
• 熟悉命令行界面（CLI）。

設置

創建個人訪問令牌

1. 登錄到您的 Supabase 控制檯。
2. 進入“設置” > “安全” > “訪問控制”部分。
3. 點擊“創建令牌”，併為令牌命名（例如：mcp-server-token）。
4. 選擇所需的權限，然後點擊“創建”。

配置 MCP 客戶端

將以下內容保存到一個文件中（例如 config.json），並填寫您的 Supabase 帳戶信息：

{
  "supabaseUrl": "https://your-supabase-project-id.supabase.co",
  "apiKey": "your-anon-key-here",
  "mcpToken": "your-mcp-server-token-here"
}

💻 使用示例

以下是 MCP 提供的 Supabase 工具及其功能：

項目管理

• list_projects：列出用戶的所有 Supabase 項目。
• get_project：獲取指定項目的詳細信息。
• create_project：創建新 Supabase 項目。
• pause_project：暫停指定項目。
• restore_project：恢復已暫停的項目。
• list_organizations：列出用戶所屬的所有組織。
• get_organization：獲取指定組織的詳細信息。

數據庫操作

• list_tables：列出指定模式中的所有表。
• list_extensions：列出數據庫中的所有擴展。
• list_migrations：列出數據庫中的所有遷移。
• apply_migration：將 SQL 遷移到數據庫中。LLMs 應使用此工具進行 DDL 操作（模式更改）。
• execute_sql：執行原始 SQL 查詢。LLMs 可以使用此工具進行常規查詢，而不更改架構。
• get_logs：獲取指定服務類型的項目日誌（api、postgres、邊緣函數、身份驗證、存儲、即時）。LLMs 可以使用此工具幫助調試和服務性能監控。

項目配置

• get_project_url：獲取項目的 API URL。
• get_anon_key：獲取項目的匿名 API 密鑰。

分支（實驗性，需要付費計劃）

• create_branch：從生產分支創建開發分支。
• list_branches：列出所有開發分支。
• delete_branch：刪除指定的開發分支。
• merge_branch：將開發分支的遷移和邊緣函數合併到生產環境。
• reset_branch：重置開發分支的遷移歷史到先前版本。
• rebase_branch：基於生產分支重新生成開發分支，以解決遷移漂移問題。

開發工具

• generate_typescript_types：根據數據庫架構生成 TypeScript 類型。LLMs 可以將此內容保存到文件中，並在代碼中使用。

成本確認

• get_cost：獲取新項目或分支的成本估算。
• confirm_cost：確認用戶對新項目或分支成本的理解。這是創建新項目或分支的必要步驟。

📚 詳細文檔

其他 MCP 服務器

@supabase/mcp-server-postgrest

PostgREST MCP 服務器允許您通過 REST API 將自己的用戶連接到應用程序。有關更多詳細信息，請參見其項目 README。

資源

• 模型上下文協議：瞭解 MCP 及其功能的更多信息。

📄 許可證

該項目在 Apache 2.0 許可證下。更多內容請參見LICENSE文件。