Medieage Supabase MCP Server

## 🚀 Supabase MCP サーバー

Supabase MCP（管理コンソール）サーバーは、Supabase データベースと関連サービスの管理と操作を支援する強力なツールです。このサーバーは、SQL クエリの実行、Supabase 管理 API へのアクセス、ログの閲覧、データベースの変更履歴の自動記録など、様々な機能を提供します。

## ✨ 主な機能

### 1. PostgreSQL クエリの実行
`execute_postgresql` ツールを使用すると、ユーザーは直接データベースに SQL クエリを送信できます。リスクを軽減するため、このツールにはセキュリティモードが導入されています。

- **通常モード**：読み取り操作（SELECT）のみ許可されます。
- **書き込みモード**：書き込みや破壊的な操作が許可されますが、`live_dangerously` ツールで明示的に確認する必要があります。

また、v0.3.8 以降、すべての書き込みおよび破壊的な SQL 操作は自動的にマイグレーションスクリプトを生成し、バージョン管理システムに記録されます。ユーザーはこれらのスクリプトを使用して、データベースの変更を簡単に追跡および管理できます。

### 2. 管理 API へのアクセス
MCP サーバーを通じて、ユーザーはプログラムで Supabase 管理 API にアクセスできます。すべての API リクエストはリスクに応じて分類されます。

- **低リスク**：読み取り操作のみ（GET リクエストなど）。
- **中リスク**：データを書き込むが構造を変更しない操作（POST、PUT リクエストなど）。
- **高リスク**：データベース構造を破壊したりデータを失う可能性のある操作（DELETE エンドポイントなど）。

すべての高リスク操作は、`unsafe` モードを有効にした上で明示的に確認する必要があります。

### 3. データベースマイグレーションのバージョン管理
v0.3.8 以降、MCP サーバーはすべての書き込みおよび破壊的な SQL 操作に対して自動的にマイグレーションスクリプトを生成します。これらのスクリプトは、データベースの変更を追跡し、最新のデータベーススキーマがバージョン管理システムに含まれるようにするのに役立ちます。

### 4. セキュリティモード
**統一セキュリティモード** は v0.3.8 以降、すべてのサービス（データベース、API、SDK を含む）に適用されます。操作のリスクレベルに応じて、異なる制御ポリシーが設定されています。

- **低リスク**：常に許可されます。
- **中リスク**：`unsafe` モードを有効にする必要があります。
- **高リスク**：`unsafe` モードを有効にし、明示的に確認する必要があります。
- **極高リスク**：完全に禁止されます（プロジェクトの削除など）。

### 5. クエリ確認プロセス
すべての高リスク操作（データベースクエリまたは API リクエスト）は、`unsafe` モードが有効になっていてもブロックされます。ユーザーは明示的に承認する必要があります。

## 📚 ドキュメント

### データベース管理
- **基本的な SQL 実行**：SELECT、INSERT、UPDATE、DELETE 操作をサポートします。
- **トランザクション処理**：単一のコミットまたはロールバックのトランザクションをサポートします。
- **接続プールのサポート**：pooled および direct タイプのデータベース接続に対応しています。

### API アクセス
- **リソース管理**：ストレージ、リアルタイム通信（RTC）、エッジ関数、スケジュールされたタスクなどを含みます。
- **ログクエリ**：時間、テキスト検索、フィールドフィルタリング、またはカスタム SQL クエリによるログ分析機能を提供します。

### 自動化とツール
- **マイグレーションスクリプトの生成**：すべての書き込みおよび破壊的な SQL 操作に対して自動的にマイグレーションファイルを生成します。
- **バージョン管理の統合**：データベースの変更をバージョン管理システムに記録し、追跡と管理を容易にします。

## 🔧 技術詳細

### v0.3.8 更新内容
- すべての操作タイプに適用される統一セキュリティモードを導入しました。
- 高リスク操作の明示的な確認メカニズムを実装しました。
- マイグレーションスクリプトを自動生成し、バージョン管理システムに記録するようになりました。

### v0.3.7 更新内容
- リアルタイム通信（RTC）およびスケジュールされたタスクのログクエリ機能を提供しました。
- トランザクション処理ロジックを最適化し、単一のコミットまたはロールバックをサポートするようにしました。
- エラー処理メカニズムを強化し、全体的な安定性を向上させました。

## 💻 使用例

### 基本的な使用法
```python
# 例：PostgreSQL クエリを実行し、マイグレーションスクリプトを生成する
from supabase_mcp import MCPClient

client = MCPClient(unsafe_mode=True)
response = client.execute_postgresql("SELECT * FROM users", live_dangerously=True)

# 例：Supabase 管理 API にアクセスする
api_response = client.access_management_api(resource="storage", action="list_buckets")

# 例：データベースのログを確認する
logs = client.get_logs(start_time="2023-10-01 00:00:00", end_time="2023-10-02 00:00:00")