Supabase Self Host

🚀 macOS上でDockerホストのMCPを使用してSupabaseをクエリする

このガイドでは、macOS上でローカルのMCP（モデルコンテキストプロトコル）サーバーインスタンスを設定し、SupabaseのPostgreSQLデータベースをクエリする方法を説明します。

🚀 クイックスタート

本ガイドでは、macOS上でローカルのMCP（モデルコンテキストプロトコル）サーバーインスタンスを設定し、SupabaseのPostgreSQLデータベースをクエリする方法を説明します。

✨ 主な機能

• macOS上でのローカルMCPサーバーインスタンスの設定。
• SupabaseのPostgreSQLデータベースへのクエリ実行。
• 自然言語クエリによるデータベースとの対話。

📦 インストール

前提条件

• Supabaseアカウントとプロジェクトの資格情報（データベースパスワード、プロジェクトID、接続情報）を持っていること。
• Docker Desktop for macOSがインストールされていること（https://www.docker.com/products/docker-desktop/）。

手順

1. Dockerのインストール Docker公式サイトの説明に従って、Docker Desktop for macOSをダウンロードしてインストールします。
2. 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パスワード" を実際のパスワードに置き換えてください。
• "あなたのデータベース名" を実際のデータベース名に置き換えてください。

このファイルは2つのサービスを定義しています。

• db：公式のSupabase PostgreSQLコンテナを実行します。ポート5432を公開し、"db-data" という名前のDockerボリュームを使用してデータを永続化します。
• mcp：Node 18コンテナを使用して、npxでMCPサーバーを実行します。PostgreSQLコンテナに接続し、ポート3000で公開します。

3. 環境の設定 docker-compose.ymlファイル内のSupabase接続情報（データベースパスワードや名前など）が正しく更新されていることを確認してください。また、個別の.envファイルを使用してこれらの変数を管理することもできます。
4. Dockerコンテナの起動
   1. ターミナルを開きます。
   2. docker-compose.ymlファイルが含まれるディレクトリに移動します。
   3. 以下のコマンドを実行して、コンテナをバックグラウンドで起動します。

docker-compose up -d

このコマンドは、必要なイメージをダウンロードし（まだダウンロードされていない場合）、コンテナを作成し、バックグラウンドタスクとして実行します。 5. サービスの検証 以下のコマンドを実行して、すべてのサービスが正常に動作していることを確認します。

docker-compose ps

"supabase-db" と "mcp-supabase" コンテナの状態が "Up" と表示されるはずです。トラブルシューティングが必要な場合は、以下のコマンドでログを確認してください。

docker-compose logs -f

6. MCPサーバーとのやり取り MCPサーバーが起動したら、ブラウザまたはAPIクライアントを使用して以下のURLにアクセスできます。

http://localhost:3000

ここから、自然言語クエリを使用してSupabaseデータベースとやり取りできます。このエンドポイントは、他の互換性のあるAIツールと統合してSQL操作を実行することもできます。

まとめ

macOS上で自前のMCPサーバーを設定し、SupabaseのPostgreSQLデータベースをクエリすることに成功しました。この設定は、開発環境に拡張したり、他のサービスと統合したりすることができ、自然言語クエリやカスタム統合を実現します。

Happy coding!