Supabase MCP サーバー

Supabaseデータベースと連携するためのモデルコンテキストプロトコル（MCP）サーバー。このサーバーは、FastMCP Python SDKを使用してモデルコンテキストプロトコルを実装し、大規模言語モデル（LLM）用のデータベース操作ツールを提供します。

特徴

フィルタリング、ページネーション、ソート機能を使用して Supabase テーブルからレコードを読み取ります
Supabase テーブルに新しいレコード (単一またはバッチ) を作成します
フィルター条件に基づいて既存のレコードを更新する
フィルター条件に基づいてテーブルからレコードを削除する
MCPのStdioトランスポートを使用して通信します

前提条件

Python 3.8以上
テーブルがすでに設定されているSupabaseプロジェクト
認証用の Supabase サービスロールキー

インストール

このリポジトリをクローンします:
git clone https://github.com/gevans3000/supabase-mcp.git cd supabase-mcp
仮想環境をセットアップします (推奨):
# Create a virtual environment python -m venv venv # Activate the virtual environment # On Windows: venv\Scripts\activate # On macOS/Linux: source venv/bin/activate
依存関係をインストールします。
pip install -r requirements.txt
環境変数を設定します。
- .env.exampleファイルを.envにコピーします。
  cp .env.example .env # On Windows, use: # copy .env.example .env
- .envファイルに Supabase URL とサービスロールキーを入力します。
  SUPABASE_URL=your_supabase_project_url SUPABASE_SERVICE_ROLE_KEY=your_supabase_service_role_key

使用法

サーバーの起動

仮想環境がアクティブになっていることを確認してから、サーバーを実行します。

python server.py

サーバーは Stdio トランスポートを使用するため、標準入力で MCP 要求をリッスンし、標準出力で応答します。

MCPクライアントとの統合

このサーバーはモデルコンテキストプロトコル（MCP）を実装しており、MCP対応のあらゆるクライアントと統合できます。例えば、MCPツールをサポートするLLMフレームワークと連携して使用できます。

Windsurf/Cursor MCP設定への追加

この MCP サーバーを Windsurf または Cursor 構成に追加するには:

mcp_config.jsonファイルを見つけます。
- Windows: C:\Users\<username>\.codeium\windsurf\mcp_config.json
- macOS: ~/.codeium/windsurf/mcp_config.json
- Linux: ~/.codeium/windsurf/mcp_config.json
Supabase MCP サーバーをmcpServersセクションに追加します。

{
  "mcpServers": {
    // ... other servers
    "supabase": {
      "command": "python",
      "args": [
        "/path/to/your/supabase-mcp/server.py"
      ],
      "env": {
        "SUPABASE_URL": "your_supabase_url",
        "SUPABASE_SERVICE_ROLE_KEY": "your_supabase_key"
      }
    }
  }
}

/path/to/your/supabase-mcp/server.pyを server.py ファイルへの絶対パスに置き換えます。

注: 分離性を高めるために、仮想環境から Python 実行ファイルを使用できます。

{
  "mcpServers": {
    "supabase": {
      "command": "/path/to/your/venv/bin/python",  // or "venv\\Scripts\\python.exe" on Windows
      "args": [
        "/path/to/your/supabase-mcp/server.py"
      ]
    }
  }
}

変更を適用するには、Windsurf/Cursor アプリケーションを再起動します。
Supabase MCP ツールが AI アシスタントで利用できるようになります。

ツールの説明

サーバーは次のツールを提供します。

1. レコードの読み取り

柔軟なクエリオプションを使用して、Supabase データベーステーブルからレコードを読み取ります。

パラメータ:

table （文字列、必須）: 読み取るテーブルの名前
columns (文字列、オプション、デフォルト: "*"): 選択する列 (カンマ区切り、またはすべてを指定する場合は *)
filters （オブジェクト、オプション）：キーと値のペアとしてのフィルタリング条件
limit (整数、オプション): 返されるレコードの最大数
offset （整数、オプション）：ページ区切りでスキップするレコード数
order_by (オブジェクト、オプション): 列:方向のペアとして並べ替えオプションを指定します。

例：

{
  "table": "users",
  "columns": "id,name,email",
  "filters": {"is_active": true},
  "limit": 10,
  "offset": 0,
  "order_by": {"created_at": "desc"}
}

2. レコードを作成する

Supabase データベーステーブルに 1 つ以上のレコードを作成します。

パラメータ:

table （文字列、必須）: レコードを作成するテーブルの名前
records （オブジェクトまたは配列、必須）: 作成する単一のレコードオブジェクトまたはレコードオブジェクトの配列

例（単一レコード）:

{
  "table": "users",
  "records": {
    "name": "John Doe",
    "email": "john@example.com",
    "role": "user"
  }
}

例 (複数のレコード):

{
  "table": "users",
  "records": [
    {
      "name": "John Doe",
      "email": "john@example.com",
      "role": "user"
    },
    {
      "name": "Jane Smith",
      "email": "jane@example.com",
      "role": "admin"
    }
  ]
}

3. レコードの更新

フィルター条件に基づいて、Supabase データベーステーブル内の既存のレコードを更新します。

パラメータ:

table （文字列、必須）: レコードを更新するテーブルの名前
updates （オブジェクト、必須）: キーと値のペアとして更新するフィールド
filters （オブジェクト、必須）：更新するレコードを識別するためのフィルタリング条件

例：

{
  "table": "users",
  "updates": {
    "is_verified": true,
    "last_login_at": "2025-04-04T15:30:00Z"
  },
  "filters": {
    "id": 123
  }
}

4. レコードの削除

フィルター条件に基づいて Supabase データベーステーブルからレコードを削除します。

パラメータ:

table （文字列、必須）: レコードを削除するテーブルの名前
filters （オブジェクト、必須）: 削除するレコードを識別するためのフィルタリング条件

例：

{
  "table": "expired_sessions",
  "filters": {
    "expires_at": {"lt": "2025-01-01T00:00:00Z"}
  }
}

発達

プロジェクト構造

server.py : メイン MCP サーバーの実装
supabase_client.py : Supabase クライアントラッパー
requirements.txt : Python の依存関係
.env.example : 環境変数ファイルの例

新しいツールの追加

サーバーに新しいツールを追加するには:

server.pyでツールのリクエストパラメータの Pydantic モデルを定義します。
SupabaseMCPServerクラスにハンドラーメソッドを追加する
_register_toolsメソッドで、わかりやすい名前とドキュメントを付けてツールを登録します。

ライセンス

MITライセンス

貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。