Supabase Self Host

🚀 在 macOS 上使用 Docker 主機自己的 MCP 以查詢 Supabase

本指南將簡潔明瞭地指導您在 macOS 系統上，設置本地 MCP（模型上下文協議）服務器實例，從而實現對 Supabase PostgreSQL 數據庫的查詢操作。

🚀 快速開始

先決條件

• 您需要擁有一個 Supabase 賬戶，同時準備好項目憑證，包括數據庫密碼、項目 ID 以及連接信息。
• 確保您已經安裝了 Docker Desktop for macOS，您可以從 這裡 進行下載安裝。

📦 安裝指南

第一步：安裝 Docker

您可以按照 Docker 官網的說明，下載並安裝 Docker Desktop for macOS。

第二步：創建 docker-compose.yml 文件

1. 打開您習慣使用的文本編輯器。
2. 創建一個名為 "docker-compose.yml" 的新文件。
3. 將以下內容複製粘貼到該文件中：

version: '3.8'
services:
  db:
    image: supabase/postgres:15.8.1.049
    container_name: supabase-db
    restart: unless-stopped
    environment:
      POSTGRES_PASSWORD: 您的 PostgreSQL 密碼
      POSTGRES_DB: 您的數據庫名稱
    ports:
      - "5432:5432"
    volumes:
      - db-data:/var/lib/postgresql/data

  mcp:
    image: node:18
    container_name: mcp-supabase
    working_dir: /app
    # 這條命令用於運行 MCP 服務器。
    command: >
      sh -c "npx -y @modelcontextprotocol/server-postgres 'postgres://postgres:您的 PostgreSQL 密碼@db:5432/您的數據庫名稱'"
    depends_on:
      - db
    ports:
      - "3000:3000"
    environment:
      NODE_ENV: production

volumes:
  db-data:

注意：

• 請將 "您的 PostgreSQL 密碼" 替換為您的實際密碼。
• 請將 "您的數據庫名稱" 替換為您的實際數據庫名稱。

此文件定義了兩個服務：

• db：運行官方的 Supabase PostgreSQL 容器，它會暴露端口 5432，並使用名為 "db-data" 的 Docker 捲來持久化數據。
• mcp：使用 Node 18 容器通過 npx 運行 MCP 服務器，它會連接到 PostgreSQL 容器，並在端口 3000 上暴露。

第三步：配置您的環境

要確保已正確更新 docker-compose.yml 文件中的 Supabase 連接信息，例如數據庫密碼和名稱。您也可以使用單獨的 .env 文件來管理這些變量。

第四步：啟動 Docker 容器

1. 打開終端。
2. 切換到包含 docker-compose.yml 文件的目錄。
3. 運行以下命令，以在分離模式下啟動容器：

docker-compose up -d

該命令會拉取所需的鏡像（如果尚未下載），創建容器，並將其作為背景任務運行。

第五步：驗證服務

執行以下命令，檢查所有服務是否正常運行：

docker-compose ps

您應該看到 "supabase-db" 和 "mcp-supabase" 容器狀態為 "Up"。如果需要進行故障排除，請查看日誌：

docker-compose logs -f

第六步：與 MCP 服務器交互

MCP 服務器運行後，您可以通過瀏覽器或 API 客戶端進行訪問：

http://localhost:3000

您可以從此處使用自然語言查詢，與 Supabase 數據庫進行交互。此端點還可以與其他兼容的 AI 工具集成，以執行 SQL 操作。

🔚 結論

恭喜您，您已經成功在 macOS 上設置了自託管的 MCP 服務器，可用於查詢您的 Supabase PostgreSQL 數據庫。此設置可以進一步擴展，或與其他服務集成到您的開發環境中，從而實現自然語言查詢和構建自定義集成。

祝您編碼愉快！