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

Install Server

HTTP connection URL

security – no known vulnerabilities

license - not found

quality - confirmed to work

How are these scores calculated?

hybrid server

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

Tools

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

Related Resources

Reddit Discussion about this server

Related MCP Servers

Supabase MCP Server
adiletD
-
security
F
license
-
quality
A Model Context Protocol server that enables querying feature suggestions from a Supabase database, allowing AI tools like Cursor and Claude to access and display feature request data.
Last updated -
TypeScript
Supabase MCP Server
Cappahccino
-
security
A
license
-
quality
A Model Context Protocol server that enables Claude and other LLMs to perform database operations and invoke Edge Functions within Supabase through natural language.
Last updated -
790
3
TypeScript
MIT License
Supabase MCP Server
gevans3000
-
security
F
license
-
quality
Implements the Model Context Protocol to provide LLMs with tools for interacting with Supabase databases, supporting operations like reading, creating, updating, and deleting records with filtering and pagination capabilities.
Last updated -
Python
Supabase MCP Server
ninad7007
-
security
A
license
-
quality
A Model Context Protocol server that enables AI tools to interact with Supabase databases, providing tools for reading, creating, updating, and deleting records in Supabase tables.
Last updated -
Python
MIT License

View all related MCP servers

Supabase MCP Server