hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

Enables querying Supabase database tables with filtering options and generating TypeScript types from database schemas
Generates TypeScript type definitions from Supabase database schemas for use in development

Supabase MCP サーバー

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

特徴

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

前提条件

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ファイルを参照

You must be authenticated.

A

security – no known vulnerabilities

F

license - not found

A

quality - confirmed to work

Tools

Supabase データベースのクエリと、Model Context Protocol インターフェースを介した TypeScript 型の生成を可能にし、スキーマ選択、列フィルタリング、ページ区切りなどの機能をサポートします。

Related Resources

Reddit Discussion about this server

Supabase MCP Server