Supabase MCP

🚀 Supabase MCP サーバー

Supabase プロジェクトを Cursor、Claude、Windsurf などの AI アシスタントに接続できます。

モデルコンテキストプロトコル (MCP) は、大規模言語モデル（LLMs）と Supabase などの外部サービス間の通信方法を標準化します。これにより、LLMs は Supabase プロジェクトに直接接続し、プロジェクト管理、データベース操作の実行、コード生成などのさまざまな操作を実行できます。

🚀 クイックスタート

前提条件

始める前に、以下の条件を満たしていることを確認してください。

• 有効な Supabase アカウント。
• Node.js と npm がインストールされ、構成されている。
• コマンドラインインターフェイス（CLI）に慣れている。

設定

個人用アクセストークンの作成

1. Supabase コンソールにログインします。
2. 「設定」>「セキュリティ」>「アクセス制御」セクションに移動します。
3. 「トークンの作成」をクリックし、トークンに名前を付けます（例：mcp-server-token）。
4. 必要な権限を選択し、「作成」をクリックします。

MCP クライアントの構成

以下の内容をファイル（例：config.json）に保存し、Supabase アカウント情報を入力してください。

{
  "supabaseUrl": "https://your-supabase-project-id.supabase.co",
  "apiKey": "your-anon-key-here",
  "mcpToken": "your-mcp-server-token-here"
}

✨ 主な機能

ツール

以下は、MCP が提供する Supabase ツールとその機能です。

プロジェクト管理

• list_projects：ユーザーのすべての Supabase プロジェクトをリストします。
• get_project：指定されたプロジェクトの詳細情報を取得します。
• create_project：新しい Supabase プロジェクトを作成します。
• pause_project：指定されたプロジェクトを一時停止します。
• restore_project：一時停止されたプロジェクトを復元します。
• list_organizations：ユーザーが所属するすべての組織をリストします。
• get_organization：指定された組織の詳細情報を取得します。

データベース操作

• list_tables：指定されたスキーマ内のすべてのテーブルをリストします。
• list_extensions：データベース内のすべての拡張機能をリストします。
• list_migrations：データベース内のすべてのマイグレーションをリストします。
• apply_migration：SQL マイグレーションをデータベースに適用します。LLMs は DDL 操作（スキーマ変更）にこのツールを使用する必要があります。
• execute_sql：生の SQL クエリを実行します。LLMs は、スキーマを変更せずに通常のクエリを実行するためにこのツールを使用できます。
• get_logs：指定されたサービスタイプ（api、postgres、エッジ関数、認証、ストレージ、リアルタイム）のプロジェクトログを取得します。LLMs は、デバッグやサービスパフォーマンス監視にこのツールを使用できます。

プロジェクト構成

• get_project_url：プロジェクトの API URL を取得します。
• get_anon_key：プロジェクトの匿名 API キーを取得します。

ブランチ（実験的、有料プランが必要）

• create_branch：本番ブランチから開発ブランチを作成します。
• list_branches：すべての開発ブランチをリストします。
• delete_branch：指定された開発ブランチを削除します。
• merge_branch：開発ブランチのマイグレーションとエッジ関数を本番環境にマージします。
• reset_branch：開発ブランチのマイグレーション履歴を以前のバージョンにリセットします。
• rebase_branch：マイグレーションのずれを解決するために、本番ブランチを基に開発ブランチを再生成します。

開発ツール

• generate_typescript_types：データベーススキーマに基づいて TypeScript 型を生成します。LLMs はこの内容をファイルに保存し、コードで使用できます。

コスト確認

• get_cost：新しいプロジェクトまたはブランチのコスト見積もりを取得します。
• confirm_cost：ユーザーが新しいプロジェクトまたはブランチのコストを理解していることを確認します。これは、新しいプロジェクトまたはブランチを作成するための必須手順です。

その他の MCP サーバー

@supabase/mcp-server-postgrest

PostgREST MCP サーバーを使用すると、REST API を介して独自のユーザーをアプリケーションに接続できます。詳細については、プロジェクトの README を参照してください。

📚 ドキュメント

リソース

• モデルコンテキストプロトコル：MCP とその機能の詳細を学ぶことができます。

📄 ライセンス

このプロジェクトは Apache 2.0 ライセンスの下で提供されています。詳細については、LICENSE ファイルを参照してください。