Supabase MCP サーバー
Supabaseデータベースと連携するためのモデルコンテキストプロトコル（MCP）サーバー。このサーバーは、FastMCP Python SDKを使用してモデルコンテキストプロトコルを実装し、大規模言語モデル（LLM）用のデータベース操作ツールを提供します。
特徴
フィルタリング、ページネーション、ソート機能を使用して Supabase テーブルからレコードを読み取ります
Supabase テーブルに新しいレコード (単一またはバッチ) を作成します
フィルター条件に基づいて既存のレコードを更新する
フィルター条件に基づいてテーブルからレコードを削除する
MCPのStdioトランスポートを使用して通信します
Related MCP server: Supabase MCP Server
前提条件
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.jsonmacOS:
~/.codeium/windsurf/mcp_config.jsonLinux:
~/.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メソッドで、わかりやすい名前とドキュメントを付けてツールを登録します。
ライセンス
貢献
貢献を歓迎します！お気軽にプルリクエストを送信してください。