インストール
pipx install supabase-mcp-server向いている人
このガイドは、このコミュニティ Query MCP をまだ使っており、IDE の中で SQL を安全に実行するか Supabase Management API を呼びたい人向け。公式の主経路は pipx で supabase-mcp-server を入れ、stdio で Cursor、Windsurf、Cline につなぐこと。作者は積極保守しないと宣言し、公式の後継リポジトリを指している。長期案を選ぶなら、まず後継を見る。このリポジトリを唯一の入口にしない。
後継リポジトリ：
https://github.com/supabase-community/supabase-mcp
まず read-only モードで SQL を走らせる人に向く。根拠は read-only / read-write を制御でき、実行時に risk level assessment を行い、SQL を safe、write、destructive の三段階に分けると書く。最初から destructive 文を走らせる用途には向かない。名指しされていないツール関数名を実証済みインタフェースにもしない。
3分で最初の試行を終える
公式推奨インストールは次のとおり。前提：手元で pipx が動くこと。設定場所は stdio を扱える MCP クライアント。同時に uv pip install をもう一つの優先インストールにしない。
pipx install supabase-mcp-server
このリポジトリページ：
https://github.com/alexander-zuev/supabase-mcp-server
最初の試行は公式の読み取り専用 SQL 能力：実行モードを read-only にし、データを変えない照会を1本走らせる。成功の合図は照会結果が返ることであり、安全ポリシーに遮られることではない。読み取り専用でもあなたの Supabase/Postgres に接続する。ネットワークもデータベースアクセスもない、とは読まない。サーバ本体は asyncpg を使い、手元の PostgreSQL 開発ライブラリにはもう依存しない。local Supabase instance を動かしているときだけ、まだ PostgreSQL が必要。
利用ケース
ケース1：読み取り専用で数を見る。対応は Control read-only ... SQL query execution。根拠はツール関数名もサンプル SQL も書いていない。作らない。成功時は結果が見え、リスク評価が付くこともある。
ケース2：schema を変える、または Management API / Auth Admin SDK を呼ぶ。対応は manage schema changes、call the Supabase Management API、use Auth Admin SDK。これは書き込み：呼び出し前に write モードであること、三段階安全で safe、write、destructive のどれに印されているかを確認する。成功の合図は変更が安全コントロールに受け入れられること。公式の取り消し手順がないものを、気軽に戻せるとは書かない。
利用の境界
作者は積極保守していない。読み取り専用/読み書きモードと三段階安全は内蔵コントロールであり、ゼロリスクではない。根拠は具体的なツール名冊、秘密変数名、削除手順を出していない。uv インストールは文書にある別のパッケージマネージャコマンドに過ぎない。pipx 主経路と並べない。