Supabase MCP Server Fqq

🚀 在 IDE 中配置 Supabase MCP 服務器指南

本指南將詳細介紹如何在 IDE 中配置 Supabase MCP 服務器，幫助您提升開發效率。

📦 安裝指南

使用 pip 安裝

在終端中運行以下命令以安裝 supabase-mcp-server：

pip install supabase-mcp-server

驗證安裝

安裝完成後，可以通過運行以下命令驗證是否安裝成功：

supabase-mcp-server --version

如果顯示版本號，則表示安裝成功。

🛠️ 配置指南

通用配置步驟

1. 獲取 Supabase 賬戶信息

   • 登錄 Supabase 控制檯
   • 進入項目設置，找到 anon_key 和 api_key

2. 創建 MCP 配置文件

   • 在項目根目錄下創建一個名為 .supabase_mcp.json 的文件
   • 添加以下內容：

{
    "region": "asia-1",  // 根據你的區域選擇正確的區域
    "project_ref": "your_project_ref",
    "db_url": "postgresql://localhost:5432/your_database_name"
}

VSCode 配置

1. 安裝擴展

   • 在 VSCode 中，進入擴展市場，搜索並安裝 Supabase MCP Server 擴展

2. 配置設置

   • 打開 VSCode 的設置（Ctrl + ,）
   • 搜索 supabase mcp server
   • 填寫 project_ref, anon_key, 和 api_key

3. 啟動服務器

   • 在命令面板中運行：Supabase: Start MCP Server

IntelliJ IDEA 配置

1. 安裝插件

   • 打開 IDEA，進入 File > Settings > Plugins
   • 搜索並安裝 Supabase MCP Server 插件

2. 配置設置

   • 進入 File > Settings > Tools > Supabase MCP Server
   • 填寫 project_ref, anon_key, 和 api_key

3. 啟動服務器

   • 右鍵點擊項目目錄，選擇 Supabase: Start MCP Server

💻 使用示例

數據庫查詢工具

從 v0.3.0 版本開始，服務器支持讀寫模式和只讀模式的 SQL 查詢。

基礎用法

以下是一些可用工具及其功能：

• get_db_schemas：列出所有數據庫架構及其大小和表數量
• get_tables：列出架構中的所有表格及其大小、行數和元數據
• get_table_schema：獲取表的詳細結構，包括列、鍵和關係
• execute_sql_query：執行帶有驗證的原始 SQL 查詢

高級用法

• 模式支持：
  • 只讀模式：默認情況下僅允許只讀查詢
  • 讀寫模式：需要顯式切換以啟用所有操作，切換命令：supabase-mcp-server --mode=read-write

管理 API 工具

從 v0.3.0 版本開始，支持通過管理 API 發送任意請求，並帶有自動注入的項目標識符和安全模式控制。

基礎用法

以下是一些可用工具及其功能：

• send_management_api_request：發送到 Supabase 管理 API 的任意請求，帶有自動注入的項目標識符和安全模式控制
• get_api_keys：獲取項目的 API 密鑰

高級用法

• 安全模式支持：
  • 默認模式：僅允許讀取操作
  • 開發者模式：啟用寫入操作，需謹慎使用

❓ 故障排除

常見問題

1. 無法連接到數據庫
   • 檢查 db_url 是否正確
   • 確保數據庫服務正在運行
2. 權限問題
   • 確保使用的 API 密鑰具有足夠權限
3. 版本不兼容
   • 確認 supabase-mcp-server 版本與 Supabase 服務版本匹配

聯繫支持

• 提交 issue 到 GitHub 倉庫
• 加入 Supabase 社區論壇尋求幫助

🚧 未來規劃

計劃功能

• 支持更多區域的 MCP 服務器
• 增加對 MongoDB 的支持
• 實現更精細的安全策略

貢獻指南

• 歡迎提交 PR 和 issue
• 參與 GitHub 倉庫 開發

通過以上步驟，您可以輕鬆配置並使用 Supabase MCP 服務器，提升開發效率。