Supabase MCP サーバー

Supabaseデータベースとやり取りするためのモデルコンテキストプロトコル（MCP）サーバー。このサーバーは、MCPインターフェースを介してテーブルをクエリしたり、TypeScript型を生成したりするためのツールを提供します。

特徴

クエリテーブル: 次のサポートを使用して任意のテーブルでクエリを実行します。
- スキーマの選択
- 列フィルタリング
- 複数の演算子を含むWhere句
- ページネーション
- エラー処理
型生成: データベースの TypeScript 型を生成します。
- あらゆるスキーマ (public、auth、api など) のサポート
- ローカルとリモートの両方の Supabase プロジェクトで動作します
- コンソールへの直接出力
- 自動プロジェクト参照検出

Related MCP server: Supabase MCP Server

前提条件

Node.js (v16 以上)
Supabase プロジェクト (ローカルまたはホスト)
Supabase CLI (型生成用)

インストール

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

git clone https://github.com/yourusername/supabase-mcp-server.git cd supabase-mcp-server

依存関係をインストールします:

npm install

Supabase CLI をインストールします (型生成に必要)。

# Using npm npm install -g supabase # Or using Homebrew on macOS brew install supabase/tap/supabase

構成

Supabase の資格情報を取得します。
- ホストされたプロジェクトの場合:
  1. Supabaseプロジェクトダッシュボードに移動します
  2. プロジェクト設定 > API に移動します
  3. プロジェクト URL と service_role キー (anon キーではありません) をコピーします。
- ローカルプロジェクトの場合:
  1. ローカルのSupabaseインスタンスを起動する
  2. ローカル URL を使用します (通常はhttp://localhost:54321 )
  3. ローカルのservice_roleキーを使用する
環境変数を設定します。

# Create a .env file (this will be ignored by git) echo "SUPABASE_URL=your_project_url SUPABASE_KEY=your_service_role_key" > .env

サーバーを構築します。

npm run build

Claude Desktopとの統合

Claude デスクトップの設定を開きます。
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
- Linux: ~/.config/Claude/claude_desktop_config.json
サーバー構成を追加します。

{ "mcpServers": { "supabase": { "command": "node", "args": ["/absolute/path/to/supabase-mcp-server/build/index.js"], "env": { "SUPABASE_URL": "your_project_url", "SUPABASE_KEY": "your_service_role_key" } } } }

VSCode拡張機能との統合

VSCode 設定を開きます。
- macOS: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
- Windows: %APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json
- Linux: ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
サーバー構成を追加します (Claude Desktop と同じ形式)。

使用例

テーブルのクエリ

// Query with schema selection and where clause <use_mcp_tool> <server_name>supabase</server_name> <tool_name>query_table</tool_name> <arguments> { "schema": "public", "table": "users", "select": "id,name,email", "where": [ { "column": "is_active", "operator": "eq", "value": true } ] } </arguments> </use_mcp_tool>

型の生成

// Generate types for public schema <use_mcp_tool> <server_name>supabase</server_name> <tool_name>generate_types</tool_name> <arguments> { "schema": "public" } </arguments> </use_mcp_tool>

利用可能なツール

クエリテーブル

スキーマ選択と where 句のサポートを使用して特定のテーブルをクエリします。

パラメータ:

schema (オプション): データベーススキーマ (デフォルトは public)
table （必須）: クエリするテーブルの名前
select （オプション）: カンマ区切りの列リスト
where (オプション): 次の条件の配列:
- column : 列名
- operator : eq、neq、gt、gte、lt、lte、like、ilike、is のいずれか
- value : 比較する値

生成型

Supabase データベーススキーマの TypeScript 型を生成します。

パラメータ:

schema (オプション): データベーススキーマ (デフォルトは public)

トラブルシューティング

型生成の問題

Supabase CLI がインストールされていることを確認します。

supabase --version

ローカルプロジェクトの場合:
- ローカルのSupabaseインスタンスが実行中であることを確認してください
- service_roleキーが正しいことを確認してください
ホストされたプロジェクトの場合:
- プロジェクト参照が正しいことを確認してください（URL から抽出）
- anonキーではなくservice_roleキーを使用していることを確認してください

クエリの問題

スキーマとテーブル名を確認してください
SELECT句とWHERE句の列名を確認する
service_role キーに必要な権限があることを確認してください

貢献

リポジトリをフォークする
機能ブランチを作成します: git checkout -b feature/my-feature
変更をコミットします: git commit -am 'Add my feature'
ブランチにプッシュする: git push origin feature/my-feature
プルリクエストを送信する

ライセンス

MITライセンス - 詳細はLICENSEファイルを参照

Deploy Server

A

security – no known vulnerabilities

F

license - not found

A

quality - confirmed to work

How are these scores calculated?

Related Resources

GitHub Repository

Need Help?

Report Issue

Reddit Discussion about this server

Supabase MCP Server