Supabase MCP サーバー

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

特徴

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

  • スキーマの選択

  • 列フィルタリング

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

  • ページネーション

  • エラー処理

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

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

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

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

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

前提条件

1. Node.js (v16 以上)

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

3. Supabase CLI (型生成用)

インストール

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

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

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

構成

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

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

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

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

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

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

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

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

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

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

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

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

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 と同じ形式)。

使用例

テーブルのクエリ

型の生成

利用可能なツール

クエリテーブル

スキーマ選択と 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 がインストールされていることを確認します。

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