Supabase MCP Server (used By Deploya.dev)

🚀 Supabase MCP サーバーガイド

Supabase MCP サーバーは、Supabase を用いた開発を支援するためのツールです。簡単なインストールと強力な機能により、開発者は効率的にプロジェクトを進めることができます。

🚀 クイックスタート

supabase-mcp をインストールした後、以下のコマンドで MCP サーバーを起動できます。

supabase-mcp run

デフォルトでは、MCP サーバーは http://localhost:3000 で動作します。このアドレスにアクセスするか、API を使用してサーバーとやり取りできます。

📦 インストール

最新の Python パッケージを以下のコマンドでインストールします。

pip install supabase-mcp

特定のバージョンが必要な場合は、PyPI を参照してください。

✨ 主な機能

データベース管理

SQL クエリツール

• send_sql_query：任意の SQL クエリを Supabase データベースに送信します。以下の機能をサポートしています。
  • プロジェクト参照（Project Ref）の自動注入
  • セキュリティモードの制御
  • 結果を Python オブジェクトに整形し、属性アクセスをサポート（例: result.user.id）

データベースメタデータ

• get_sql_schema：完全なデータベーススキーマ情報を取得します。
• list_tables：すべてのテーブルをリストします。
• describe_table：特定のテーブルの構造を説明します。
• list_columns：指定されたテーブルのすべての列をリストします。

プロジェクト管理

クォータと使用状況

• get_usage_breakdown：サービスタイプ別に詳細なクォータ使用状況を取得します。
• get_project_limits：現在のプロジェクトの各種制限設定を確認します。
• monitor_health：プロジェクトの全体的な健全性を監視します。

セキュリティ制御

統一セキュリティモデル

すべての操作は統一的なセキュリティポリシーに基づいています。

1. ユーザー認証：JWT ベースの認証で、複数のログイン方法をサポートします。
2. 権限制御：細かい権限管理で、最小限の権限割り当てを確保します。
3. 監査ログ：すべての敏感な操作を記録し、後でレビューできるようにします。

セキュリティモード

• セキュリティモード：高リスク操作を制限し、誤削除やデータ漏洩を防止します。
• ブラックリスト機構：危険な操作を事前定義し、デフォルトで実行をブロックします。
• ホワイトリスト機構：指定された安全な操作を制限モードで実行できるようにします。

トランザクション処理

トランザクション管理

以下のトランザクション機能をサポートしています。

1. トランザクションロールバック：データベースの整合性を確保し、失敗時に自動的にロールバックします。
2. 長時間トランザクションの最適化：長時間トランザクションのパフォーマンスを最適化し、ロック競合を減らします。
3. 分散トランザクション：複数のデータセンター間のトランザクション調整をサポートします。

📚 ドキュメント

インストールと設定

MCP サーバーのインストール

pip install supabase-mcp

MCP サーバーの設定

config.yaml ファイルを作成します。

server:
  port: 3000
  host: localhost

auth:
  secret_key: your-secret-key-here

使用方法

基本的な使用法

MCP サーバーを起動します。

supabase-mcp run --config config.yaml

コンソールにアクセスします。

supabase-mcp console

上級機能

バッチ操作

SQL クエリのバッチ処理をサポートし、効率を向上させます。

ログ記録

詳細なログ出力で、デバッグと監視を容易にします。

よくある質問

1. プロジェクト参照（Project Ref）をどのように取得できますか？ Supabase アカウントの管理者に問い合わせてください。

2. セキュリティモードの制限に遭遇したらどうすればいいですか？ 権限設定を確認し、管理者にセキュリティポリシーの調整を依頼してください。

3. トランザクション処理が失敗したらどうすればいいですか？ ネットワークが安定していることを確認し、ログ出力を確認し、必要に応じてトランザクションをロールバックしてください。

まとめ

• インストールが簡単：pip でインストールするだけですぐに使い始めることができます。
• 機能が豊富：様々な便利なツールが統合され、開発プロセスを簡素化します。
• 安全で信頼性が高い：充実したセキュリティ機構とトランザクション管理が組み込まれています。