Selfhosted Supabase

🚀 自托管 Supabase MCP サーバー

自托管 Supabase MCP サーバーは、特定の環境で Supabase を利用するためのサーバーです。このサーバーを使用することで、独自の環境で Supabase の機能を活用できます。

🚀 クイックスタート

📦 インストール

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 ライセンスに従います。