MCP Supabase

🚀 Supabase MCP サーバー

Supabase MCP サーバー は、大規模言語モデル (LLM) が人工的な介入なしに直接 Supabase プロジェクトとやり取りできるようにします。Model Context Protocol (MCP) を通じて、LLM は安全に複雑なデータベース操作、エッジ関数の管理、プロジェクト設定の構成などを実行できます。

🚀 クイックスタート

📦 インストール

依存関係のインストール

Node.js と npm がインストールされていることを確認してください。

npm install -g node

API キーの取得

Supabase プロジェクトから anon 公開キーと管理キーを取得します。

サーバーの起動

ターミナルで以下のコマンドを実行して、MCP サーバーを起動します。

npx supabase-mcp-server --anon-key=your_anon_key --api-key=your_api_key

⚠️ 注意事項

⚠️ 重要提示

このサーバーは pre-1.0 段階であり、いくつかの破壊的な変更がある可能性があります。ただし、LLM は利用可能なツールに自動的に適応するため、ほとんどのユーザーには影響が少ないです。

💡 使用建议

generate_typescript_types ツールを使用すると、データベーススキーマに基づく TypeScript 型を生成できます。LLM はこれらの型をファイルに保存し、コードで使用することができます。

✨ 主な機能

利用可能なツール

以下は、LLM が使用できる 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 マイグレーションをデータベースに適用します。LLM は DDL 操作（スキーマ変更）にこのツールを使用する必要があります。
• execute_sql：データベースの生の SQL クエリを実行します。LLM は通常のクエリでスキーマを変更しない場合にこのツールを使用する必要があります。
• get_logs：サービスタイプに基づいて Supabase プロジェクトのログ（api、postgres、エッジ関数、認証、ストレージ、リアルタイム）を取得します。LLM はこのツールを使用して、サービスのデバッグとパフォーマンス監視を行うことができます。

エッジ関数管理

• list_edge_functions：プロジェクト内のすべてのエッジ関数をリストします。
• deploy_edge_function：新しいエッジ関数を Supabase プロジェクトにデプロイします。LLM はこのツールを使用して、新機能をデプロイしたり、既存の機能を更新したりすることができます。

プロジェクト設定

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

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

• create_branch：本番ブランチから新しい開発ブランチを作成します。
• list_branches：すべてのプロジェクトブランチをリストします。
• switch_branch：指定されたブランチに切り替えます。
• delete_branch：指定されたブランチを削除します。

その他の MCP サーバー

PostgREST MCP サーバー

REST API インターフェイスを介して PostgreSQL データベースとやり取りするための MCP サーバーです。

📚 ドキュメント

• Model Context Protocol (MCP) ドキュメント
• Supabase 開発者ドキュメント

📄 ライセンス

このプロジェクトは MIT ライセンス の保護を受けています。