Supabase MCP Selfhosted

🚀 Supabase MCP 服務器 - 自託管版

🗄️ Supabase MCP 自託管服務器 - 全面管理您的私有 Supabase 實例。本項目可助力您高效掌控私有 Supabase 實例，提升管理效率與安全性。

✨ 主要特性

• 🔐 全面管理您的私有 Supabase 實例。
• 🛠️ 提供 54 種以上的 MCP 工具，用於 Supabase 管理。
• 📊 即時監控與指標展示。
• 🚀 可在 Railway 上自動部署。
• 🔒 增強安全防護，預防 SQL 注入。
• ⚡ 針對生產環境優化性能。

🏗️ 架構

本倉庫僅包含純 Supabase MCP 服務器，無 Web 界面和中央樞紐。

Supabase MCP Server (端口 8000)
├── 🗄️ 數據庫管理
├── 🔐 認證與授權
├── 📁 存儲與文件管理
├── 🔄 即時處理與訂閱
├── 🛠️ 遷移與模式管理
├── 📊 監控與日誌記錄
└── 🚀 自動部署

🚀 快速開始

前提條件

• Python 3.11 及以上版本。
• Supabase 實例（自託管或雲服務）。
• Supabase 環境變量。

選項 A — SDK Smithery（推薦）

# 克隆倉庫
git clone https://github.com/MisterSandFR/Supabase-MCP-SelfHosted.git
cd Supabase-MCP-SelfHosted

# 安裝依賴
pip install -r requirements.txt

# （可選）如有需要，安裝 Smithery CLI
npm i -g @smithery/cli

# 啟動開發 SDK（根據您的環境選擇）
smithery dev   # 或者: smithery playground

• SDK 服務器在 pyproject.toml 中通過以下方式定義：
  • [tool.smithery] server = "supabase_mcp_server.server:create_server"
• 在 Smithery 界面部署時，配置測試配置文件，然後進行掃描。

選項 B — HTTP 自託管（兼容模式）

# 克隆倉庫
git clone https://github.com/MisterSandFR/Supabase-MCP-SelfHosted.git
cd Supabase-MCP-SelfHosted

# 安裝 Python 依賴
pip install -r requirements.txt

# 配置環境變量
export SUPABASE_URL="https://your-project.supabase.co"
export SUPABASE_ANON_KEY="your-anon-key"
export SUPABASE_SERVICE_KEY="your-service-key"  # 可選

# 啟動外部 HTTP 服務器
python src/supabase_server.py

使用 Docker（Railway / 自託管）

# 構建並啟動（如有需要，使用 Dockerfile.railway）
docker build -f Dockerfile.railway -t supabase-mcp-server .
docker run -p 8000:8000 \
  -e SUPABASE_URL="https://your-project.supabase.co" \
  -e SUPABASE_ANON_KEY="your-anon-key" \
  supabase-mcp-server

⚙️ 配置

環境變量

# Supabase 配置
SUPABASE_URL=https://your-project.supabase.co
SUPABASE_ANON_KEY=eyJ... （您的匿名密鑰）
SUPABASE_SERVICE_KEY=eyJ... （可選，用於特權操作）

# 服務器配置
PORT=8000
PYTHONUNBUFFERED=1

🛠️ 可用的 MCP 工具

數據庫（15 種工具）

• execute_sql - 執行 SQL 查詢。
• list_tables - 列出表。
• inspect_schema - 檢查模式。
• apply_migration - 應用遷移。
• backup_database - 備份數據庫。
• restore_database - 恢復數據庫。
• vacuum_analyze - 優化數據庫。
• get_database_stats - 獲取數據庫統計信息。
• create_index - 創建索引。
• drop_index - 刪除索引。
• list_extensions - 列出擴展。
• manage_extensions - 管理擴展。
• execute_psql - 執行 psql 命令。
• check_health - 檢查健康狀態。
• get_database_connections - 獲取數據庫連接。

認證（8 種工具）

• list_auth_users - 列出用戶。
• create_auth_user - 創建用戶。
• update_auth_user - 更新用戶信息。
• delete_auth_user - 刪除用戶。
• get_auth_user - 獲取用戶信息。
• verify_jwt_secret - 驗證 JWT 密鑰。
• manage_roles - 管理角色。
• manage_rls_policies - 管理 RLS 策略。

存儲（6 種工具）

• list_storage_buckets - 列出存儲桶。
• list_storage_objects - 列出存儲對象。
• manage_storage_policies - 管理存儲策略。
• upload_file - 上傳文件。
• download_file - 下載文件。
• delete_file - 刪除文件。

即時處理（4 種工具）

• list_realtime_publications - 列出即時發佈。
• manage_realtime - 管理即時處理。
• create_subscription - 創建訂閱。
• delete_subscription - 刪除訂閱。

遷移（8 種工具）

• create_migration - 創建遷移。
• list_migrations - 列出遷移。
• push_migrations - 推送遷移。
• validate_migration - 驗證遷移。
• smart_migration - 智能遷移。
• auto_migrate - 自動遷移。
• sync_schema - 同步模式。
• import_schema - 導入模式。

監控（5 種工具）

• get_logs - 獲取日誌。
• metrics_dashboard - 指標儀表盤。
• analyze_performance - 分析性能。
• analyze_rls_coverage - 分析 RLS 覆蓋範圍。
• audit_security - 安全審計。

實用工具（8 種工具）

• generate_typescript_types - 生成 TypeScript 類型。
• generate_crud_api - 生成 CRUD API。
• cache_management - 緩存管理。
• environment_management - 環境管理。
• manage_secrets - 管理密鑰。
• manage_functions - 管理函數。
• manage_triggers - 管理觸發器。
• manage_webhooks - 管理 Webhook。

🔧 API 端點

MCP 服務器（HTTP 自託管）

• GET /health - 健康檢查。
• POST /mcp - 主要的 JSON-RPC 端點。
• GET /.well-known/mcp-config - MCP 配置。
• GET /mcp/tools.json - 工具發現（JSON 格式）。

專用工具

• GET /api/tools - 列出可用工具。
• POST /api/execute - 執行工具。

🚀 部署

Smithery（Python SDK） — 推薦

1. 確保 pyproject.toml 包含以下內容：
   • [tool.smithery] server = "supabase_mcp_server.server:create_server"
2. 在 Smithery → Deploy 中，選擇 Python SDK。
3. 配置測試配置文件，然後進行掃描。
   • 必需參數：SUPABASE_URL，SUPABASE_ANON_KEY

Railway（自託管）

# 部署到 Railway
railway login
railway init
railway up

Docker

# 構建並部署
docker build -t supabase-mcp-server .
docker run -p 8000:8000 supabase-mcp-server

與中央樞紐集成

本服務器設計用於與 MCP 中央樞紐 集成：

{
  "servers": {
    "supabase": {
      "name": "Supabase MCP Server",
      "host": "supabase.mcp.coupaul.fr",
      "port": 8000,
      "path": "/",
      "categories": ["database", "auth", "storage", "realtime", "security", "migration", "monitoring", "performance"]
    }
  }
}

🧪 測試配置文件（Smithery）

在 Smithery 端連接時，在測試配置文件中提供以下密鑰：

{
  "SUPABASE_URL": "https://your-project.supabase.co",
  "SUPABASE_ANON_KEY": "eyJ..."
}

如果存在緩存，請重新保存配置文件並重新進行掃描。

🔒 安全

• 輸入驗證：防止 SQL 注入。
• 速率限制：按 IP 和用戶進行限制。
• 審計日誌：記錄所有操作。
• HTTPS 加密：生產環境強制使用。
• 密鑰管理：安全管理密鑰。
• RLS 策略：保障數據安全。

📊 監控

服務器提供全面的監控功能：

• 即時性能指標。
• 結構化日誌：級別可配置。
• 自動健康檢查。
• 問題警報。
• 指標儀表盤。
• 詳細性能分析。

🤝 貢獻

1. Fork 本倉庫。
2. 創建功能分支（git checkout -b feature/amazing-feature）。
3. 提交更改（git commit -m 'Add amazing feature'）。
4. 推送到分支（git push origin feature/amazing-feature）。
5. 打開 Pull Request。

📄 許可證

本項目採用 MIT 許可證。詳情請參閱 LICENSE 文件。

🙏 致謝

• Supabase 提供平臺支持。
• Smithery 提供 MCP 生態系統。
• Supabase 社區的貢獻。

📞 支持

• 📧 郵箱：contact@coupaul.fr
• 💬 Discord：MCP 社區服務器
• 🐛 問題反饋：GitHub 問題

由 coupaul 用心打造 ❤️