Selfhosted Supabase

🚀 自託管 Supabase MCP 服務器

本項目可幫助你自託管 Supabase MCP 服務器，通過簡單的安裝和配置，就能快速搭建並運行服務。

🚀 快速開始

要使用自託管 Supabase MCP 服務器，需完成安裝和配置環境變量的步驟，之後就可以運行服務了。

📦 安裝指南

使用 npm 安裝 @supabase/supabase-js 和 pg：

npm install @supabase/supabase-js pg

🔧 配置環境變量

創建一個 .env 文件並添加以下內容：

SUPABASE_URL=your-supabase-url
SUPABASE_ANON_KEY=your-supabase-anon-key
SUPABASE_SERVICE_ROLE_KEY=your-supabase-service-key （可選）
DATABASE_URL=postgres://user:password@localhost:5432/dbname （可選）
SUPABASE_AUTH_JWT_SECRET=your-jwt-secret （可選）

💻 使用示例

基礎用法

通過 Node.js 運行：

import { createServer } from '@modelcontextprotocol/sdk'
import { SupabaseProvider } from './src/SupabaseProvider'

async function start() {
  const server = await createServer()
  server.use(new SupabaseProvider())
  await server.listen(3001)
}

start().catch(console.error)

📚 詳細文檔

CLI 選項

Usage: mcp-server [options]

Options:
  -u, --url <supabase-url>      Supabase 服務 URL
  -a, --anon-key <anon-key>     Supabase 匿名訪問密鑰
  -s, --service-key <service-key>  Supabase 服務角色密鑰（可選）
  -d, --db-url <db-url>        數據庫連接 URL（可選）
  -j, --jwt-secret <jwt-secret>  Supabase JWT 簽名密鑰（可選）
  -c, --config <config-path>    工具配置文件路徑（默認為 ./mcp-tools.json）
  -h, --help                   顯示幫助信息

配置文件示例

package.json：

{
  "scripts": {
    "start": "mcp-server --url your-supabase-url --anon-key your-anon-key"
  }
}

mcp-tools.json：

{
  "tools": {
    "supabase": {
      "version": "2.39.0",
      "path": "~/.supabase/cli"
    },
    "psql": {
      "version": "15.4",
      "path": "/usr/bin/psql"
    }
  }
}

自定義工具配置

import { defineTools } from '@modelcontextprotocol/sdk'

defineTools(() => ({
  supabase: {
    version: '2.39.0',
    path: '~/.supabase/cli'
  },
  psql: {
    version: '15.4',
    path: '/usr/bin/psql'
  }
}))

注意事項

⚠️ 重要提示

• 支持的文件類型：.sql, .psql, .js, .ts
• 使用 # 或 -- 註釋 SQL 查詢
• 忽略語言特定的註釋（如 TypeScript 的 // 和 JavaScript 的 //）

開發

• 語言：TypeScript
• 構建：使用 tsc（TypeScript 編譯器）
• 依賴項：請參閱 package.json
• 開發：在 src/ 目錄中進行修改

📄 許可證

本項目遵循 MIT 協議。