Supabase MCP Server

🚀 Supabase MCP サーバー

Supabase MCP（管理コンソール）サーバーは、Supabase データベースの管理と操作を行うための強力なツールです。SQL を通じたクエリの実行、Supabase 管理 API の統合、自動バージョン管理、セキュリティ管理など、様々な機能を提供します。MCP サーバーは、データベースと関連サービスの管理プロセスを簡素化することを目的としています。

✨ 主な機能

PostgreSQL クエリの実行

• 直接 SQL 実行: SELECT、INSERT、UPDATE、DELETE など、任意の PostgreSQL クエリの実行をサポートします。
• トランザクション処理: 原子的なトランザクションをサポートし、操作が完全に成功するか、または完全に失敗することを保証します。
• 結果の表示: 直感的な結果表示を提供し、JSON 形式の出力とカスタム列フォーマットをサポートします。

Supabase 管理 API の統合

• リソース管理: データベースオブジェクト（テーブル、列、インデックス）の直接的な作成、削除、または変更が可能です。
• 権限管理: ユーザーとロールのアクセス権限を簡単に設定できます。
• バックアップと復元: 手動または自動でデータのバックアップを実行し、バックアップから復元することができます。

セキュリティモード

• リスク分類: すべての操作はリスクレベルによって以下のように分類されます。
  • 低リスク: データの読み取りのみ（SELECT クエリ、GET API リクエスト）。
  • 中リスク: データを変更するが、構造を変更しない操作（INSERT/UPDATE/DELETE、ほとんどの POST/PUT API リクエスト）。
  • 高リスク: データベース構造を変更する、またはデータの損失を引き起こす可能性のある操作（DROP/TRUNCATE、DELETE API エンドポイント）。
  • 極高リスク: 重大な結果をもたらす操作で、完全にブロックされます（プロジェクトの削除）。

自動バージョン管理

• マイグレーションスクリプトの生成: データベースへのすべての書き込みと破壊的な SQL 操作は、自動的にマイグレーションスクリプトを生成します。
• 確認プロセス: unsafe モードでは、すべての高リスク操作はユーザーの明示的な承認が必要です。

ログと監査

• クエリ記録: 実行されたすべてのクエリとその結果を記録します。
• 監査トレース: 操作履歴の追跡とレビューを容易にするため、詳細なログ情報を提供します。

📦 インストール

パッケージマネージャーを使用したインストール

pip install supabase-mcp-server

手動インストール

ソースコードをダウンロードして実行します。

git clone https://github.com/alexander-zuev/supabase-mcp-server.git
cd supabase-mcp-server
python setup.py install

💻 使用例

データベースへの接続

デフォルトの資格情報またはカスタム設定を使用して、Supabase データベースに接続します。

クエリの実行

任意の PostgreSQL クエリを実行します。

SELECT * FROM users;

管理 API の呼び出し

MCP サーバーが提供する API メソッドを使用して、データベースリソースを管理します。

🔒 セキュリティモード

セキュリティモードの有効化

設定ファイルでセキュリティ機能を有効にします。

security:
  enabled: true

高リスク操作の確認

高リスク操作を実行する際、システムはユーザーに確認情報の入力を求めます。

📈 変更履歴

v1.0.0

• 基本的な SQL 実行と API 管理機能を含む初期バージョンがリリースされました。
• セキュリティモードとトランザクションサポートが導入されました。

v2.0.0

• 自動バージョン管理機能が追加されました。
• 高リスク操作の確認プロセスがサポートされました。
• ログ記録と監査機能が最適化されました。

v3.0.0

• セキュリティが強化され、いくつかのセキュリティホールが修正されました。
• パフォーマンス監視とリソース管理が改善されました。

🖼️ 添付画像

添付画像には、MCP サーバーの高リスク操作確認画面とクエリ結果表示画面が示されています。