Supabase MCP Server R4b

🚀 Supabase MCP サーバー

このサーバーは、モデルコンテキストプロトコル (MCP) を使用して、AI アシスタントが標準化されたツールを通じて Supabase データベースと相互作用できるようにします。

✨ 主な機能

• フィルタリングと列選択を使用してテーブルから行を読み取る
• 単一または複数のレコードを作成する
• 柔軟なフィルタ条件を使用してレコードを更新する
• 特定の条件に一致するレコードを安全に削除する
• 環境は設定に基づく
• 標準化された入出力トランスポートをサポートする

📦 インストール

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

git clone <repository-url>
cd mcp

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

python -m venv .venv
source .venv/bin/activate  # 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"],  # オプション
    "filters": {"is_active": true},      # オプション
    "limit": 10                          # オプション
}

create_records

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

{
    "table": "users",
    "records": {
        "name": "John Doe",
        "email": "john@example.com"
    }
    # または複数のレコード:
    # "records": [
    #     {"name": "John", "email": "john@example.com"},
    #     {"name": "Jane", "email": "jane@example.com"}
    # ]
}

update_records

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

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

delete_records

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

{
    "table": "users",
    # ここに元のドキュメントで続く内容があればそのまま記載
}