MCP Supabase

🚀 Supabase MCP 服務器

Supabase MCP 服務器允許大型語言模型 (LLM) 直接與 Supabase 項目交互，無需人工干預。藉助 Model Context Protocol (MCP)，LLM 能夠安全地執行復雜數據庫操作、管理邊緣函數以及配置項目設置等。

🚀 快速開始

Supabase MCP 服務器為大型語言模型與 Supabase 項目的交互提供了便利，以下是使用該服務器的基本步驟。

📦 安裝指南

安裝依賴項

確保你已經安裝了 Node.js 和 npm：

npm install -g node

獲取 API 密鑰

從你的 Supabase 項目中獲取 anon 公共密鑰和管理密鑰。

啟動服務器

在終端中運行以下命令以啟動 MCP 服務器：

npx supabase-mcp-server --anon-key=your_anon_key --api-key=your_api_key

⚠️ 注意事項

⚠️ 重要提示

此服務器處於 pre - 1.0 階段，可能會有一些破壞性更改。不過由於 LLM 會自動適應可用的工具，因此這對大多數用戶來說影響不大。

💡 使用建議

generate_typescript_types 工具可以生成基於數據庫模式的 TypeScript 類型。LLM 可以將這些類型保存到文件中並在代碼中使用。

✨ 主要特性

以下是可用於 LLM 的 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 遷移到數據庫中。LLM 應該使用此工具進行 DDL 操作（架構更改）。
• execute_sql：執行數據庫的原始 SQL 查詢。LLM 應該使用此工具進行常規查詢，而不更改架構。
• get_logs：根據服務類型獲取 Supabase 項目的日誌（api、postgres、邊緣函數、身份驗證、存儲、即時）。LLM 可以使用此工具幫助調試和監控服務性能。

邊緣函數管理

• list_edge_functions：列出項目中的所有邊緣函數。
• deploy_edge_function：部署新的邊緣函數到 Supabase 項目。LLM 可以使用此工具來部署新功能或更新現有功能。

項目配置

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

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

• create_branch：從生產分支創建新的開發分支。
• list_branches：列出所有項目分支。
• switch_branch：切換到指定分支。
• delete_branch：刪除指定分支。

📚 詳細文檔

其他 MCP 服務器

PostgREST MCP 服務器

用於通過 REST API 接口與 PostgreSQL 數據庫交互的 MCP 服務器。

資源

• Model Context Protocol (MCP) 文檔
• Supabase 開發者文檔

📄 許可證

本項目受 MIT 許可證 保護。