Supabase MCP サーバー

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

特徴

• クエリ テーブル: 次のサポートを使用して任意のテーブルでクエリを実行します。

  • スキーマの選択

  • 列フィルタリング

  • 複数の演算子を含むWhere句

  • ページネーション

  • エラー処理

• 型生成: データベースの TypeScript 型を生成します。

  • あらゆるスキーマ (public、auth、api など) のサポート

  • ローカルとリモートの両方の Supabase プロジェクトで動作します

  • コンソールへの直接出力

  • 自動プロジェクト参照検出

Related MCP server: Supabase MCP Server

前提条件

1. Node.js (v16 以上)

2. Supabase プロジェクト (ローカルまたはホスト)

3. Supabase CLI (型生成用)

インストール

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

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

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

npm install

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

# Using npm
npm install -g supabase

# Or using Homebrew on macOS
brew install supabase/tap/supabase

構成

1. Supabase の資格情報を取得します。

   • ホストされたプロジェクトの場合:

     1. Supabaseプロジェクトダッシュボードに移動します

     2. プロジェクト設定 > API に移動します

     3. プロジェクト URL と service_role キー (anon キーではありません) をコピーします。

   • ローカルプロジェクトの場合:

     1. ローカルのSupabaseインスタンスを起動する

     2. ローカル URL を使用します (通常はhttp://localhost:54321 )

     3. ローカルのservice_roleキーを使用する

2. 環境変数を設定します。

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

3. サーバーを構築します。

npm run build

Claude Desktopとの統合

1. Claude デスクトップの設定を開きます。

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Windows: %APPDATA%\Claude\claude_desktop_config.json

   • Linux: ~/.config/Claude/claude_desktop_config.json

2. サーバー構成を追加します。

{
  "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拡張機能との統合

1. 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

2. サーバー構成を追加します (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)

トラブルシューティング

型生成の問題

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

supabase --version

2. ローカルプロジェクトの場合:

   • ローカルのSupabaseインスタンスが実行中であることを確認してください

   • service_roleキーが正しいことを確認してください

3. ホストされたプロジェクトの場合:

   • プロジェクト参照が正しいことを確認してください（URL から抽出）

   • anonキーではなくservice_roleキーを使用していることを確認してください

クエリの問題

1. スキーマとテーブル名を確認してください

2. SELECT句とWHERE句の列名を確認する

3. service_role キーに必要な権限があることを確認してください

貢献

1. リポジトリをフォークする

2. 機能ブランチを作成します: git checkout -b feature/my-feature

3. 変更をコミットします: git commit -am 'Add my feature'

4. ブランチにプッシュする: git push origin feature/my-feature

5. プルリクエストを送信する

ライセンス

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