Supabase MCP Server

Supabase MCP サーバー

AI アシスタントが標準化されたツールを通じて Supabase データベースと連携できるようにする、Model Context Protocol（MCP）サーバーです。

機能

• フィルタリングや列の選択を指定して、テーブルから行を読み取ります
• 1 件または複数のレコードを作成します
• 柔軟なフィルタリングでレコードを更新します
• フィルター条件を指定してレコードを安全に削除します
• 環境変数による設定
• Stdio トランスポートに対応

インストール

1. リポジトリをクローンします：

git clone <repository-url>
cd mcp

2. 仮想環境を作成して、依存関係をインストールします：

python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
pip install -r requirements.txt

3. 環境変数を設定します： プロジェクトのルートに .env ファイルを作成し、次の内容を記述します：

SUPABASE_URL=your_project_url
SUPABASE_SERVICE_KEY=your_service_role_key

使用方法

MCP サーバーを実行します：

python -m supabase_mcp.server

利用可能なツール

read_rows

オプションでフィルタリングや列の選択を指定して、Supabase のテーブルからデータを読み取ります。

{
    "table": "users",
    "columns": ["id", "name", "email"],  # Optional
    "filters": {"is_active": true},      # Optional
    "limit": 10                          # Optional
}

create_records

テーブルに 1 件または複数のレコードを挿入します。

{
    "table": "users",
    "records": {
        "name": "John Doe",
        "email": "[email protected]"
    }
    # Or multiple records:
    # "records": [
    #     {"name": "John", "email": "[email protected]"},
    #     {"name": "Jane", "email": "[email protected]"}
    # ]
}

update_records

特定のフィルターに一致するレコードを更新します。

{
    "table": "users",
    "filters": {"id": 123},
    "data": {"status": "active"}
}

delete_records

特定のフィルターに一致するレコードを削除します。

{
    "table": "users",
    "filters": {"status": "inactive"}
}

セキュリティ

• データベース操作にはサービスロールキーを使用します
• 適切な環境設定が必要です
• すべての入力を Pydantic モデルで検証します

ライセンス

MIT ライセンス