Supabase MCP Installation Guide

🚀 Supabase MCP Server 安裝指南

本指南將逐步引導你完成 Supabase MCP Server 的安裝與配置，助你快速上手使用該服務。

🚀 快速開始

本指南將幫助你逐步完成 Supabase MCP Server 的安裝與配置。

📦 安裝指南

先決條件

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

1. 已安裝 Python 3.12 或更高版本。
   • 你可以通過在終端運行 python --version 來檢查 Python 版本。
2. 擁有兼容的 MCP 客戶端：
   • Cursor（推薦）
   • Windsurf
   • Cline
   • Claude Desktop

安裝步驟

方法 1：使用 pipx（推薦）

pipx install supabase-mcp-server

方法 2：使用 uv

uv pip install supabase-mcp-server

🔧 配置說明

必要的環境變量

必填項：

• SUPABASE_PROJECT_REF：你的 Supabase 項目 ID
• SUPABASE_DB_PASSWORD：你的數據庫密碼
• SUPABASE_REGION：託管你項目的 AWS 區域

可選項：

• SUPABASE_ACCESS_TOKEN：用於 API 管理的個人訪問令牌
• SUPABASE_SERVICE_ROLE_KEY：Auth Admin SDK 的服務角色密鑰

Windows 全局配置

1. 創建配置目錄：

mkdir -Force "$env:APPDATA\supabase-mcp"

2. 創建並編輯 .env 文件：

notepad "$env:APPDATA\supabase-mcp\.env"

3. 添加以下配置：

SUPABASE_PROJECT_REF=你的項目 ID
SUPABASE_DB_PASSWORD=你的數據庫密碼
SUPABASE_REGION=us-east-1
SUPABASE_ACCESS_TOKEN=你的訪問令牌
SUPABASE_SERVICE_ROLE_KEY=你的服務角色密鑰

項目詳細信息獲取途徑

1. Project Reference：
   • 訪問你的 Supabase 項目 URL：https://supabase.com/dashboard/project/<project-ref>
   • project-ref 是 URL 中的標識符。
2. Database Password：
   • 在創建項目時設置。
   • 或者在 Project Settings → Database 中找到。
3. Access Token：
   • 在 https://supabase.com/dashboard/account/tokens 生成。
4. Service Role Key：
   • 在 Project Settings → API → Project API keys 中找到。

💻 使用示例

與 Cursor 的集成

1. 打開 Cursor。
2. 轉到 Settings → Features → MCP Servers。
3. 添加一個新的服務器配置如下：

名稱：supabase
類型：command
命令：C:\Users\<usuario>\.local\bin\supabase-mcp-server.exe

要找到可執行文件的準確路徑：

where.exe supabase-mcp-server

🔍 驗證步驟

步驟 1：驗證安裝

打開終端並運行：

supabase-mcp-server

如果沒有任何錯誤信息，則表示安裝成功。

步驟 2：驗證配置

檢查所有環境變量是否正確設置，並確保服務器正在運行。

🛠️ 故障排除

• 如果服務器啟動失敗，請查看日誌文件以獲取更多信息。
• 確保所有環境變量都已正確配置。
• 確認你有系統的必要權限。

📚 相關資源

• Supabase MCP Server 的官方倉庫
• Supabase 文檔
• Supabase 社區

🆘 支持與反饋

如果在安裝過程中遇到問題：

1. 查看服務器日誌。
2. 確保所有環境變量都已正確設置。
3. 確認你有系統的必要權限。
4. 諮詢 GitHub 問題 部分。