Supabase MCP Installation Guide

🚀 Supabase MCP Server

このプロジェクトは、Supabase MCP Server をインストールし、設定するためのガイドを提供します。

🚀 クイックスタート

このガイドでは、Supabase MCP Server のインストールと設定を段階的にサポートします。

📦 インストール

目次

1. 前提条件
2. インストール
3. 設定
4. Cursor との統合
5. 検証
6. トラブルシューティング

前提条件

開始する前に、以下のものが必要です。

1. Python 3.12 以上がインストールされていること
   • python --version を実行して、Python のバージョンを確認できます。
2. 互換性のある MCP クライアント：
   • Cursor（推奨）
   • Windsurf
   • Cline
   • Claude Desktop

インストール

方法 1：pipx を使用する（推奨）

pipx install supabase-mcp-server

方法 2：uv を使用する

uv pip install supabase-mcp-server

設定

必要な環境変数

必須：

• SUPABASE_PROJECT_REF：あなたの Supabase プロジェクト ID
• SUPABASE_DB_PASSWORD：あなたのデータベースパスワード
• SUPABASE_REGION：あなたのプロジェクトをホストしている AWS リージョン

オプション：

• SUPABASE_ACCESS_TOKEN：API 管理用の個人用アクセストークン
• SUPABASE_SERVICE_ROLE_KEY：Auth Admin SDK のサービスロールキー

Windows のグローバル設定

1. 設定ディレクトリを作成します。

mkdir -Force "$env:APPDATA\supabase-mcp"

2. .env ファイルを作成し、編集します。

notepad "$env:APPDATA\supabase-mcp\.env"

3. 以下の設定を追加します。

SUPABASE_PROJECT_REF=あなたのプロジェクト ID
SUPABASE_DB_PASSWORD=あなたのデータベースパスワード
SUPABASE_REGION=us-east-1
SUPABASE_ACCESS_TOKEN=あなたのアクセストークン
SUPABASE_SERVICE_ROLE_KEY=あなたのサービスロールキー

あなたのプロジェクトの詳細情報の取得先

1. Project Reference：

   • あなたの Supabase プロジェクトの URL https://supabase.com/dashboard/project/<project-ref> にアクセスします。
   • project-ref は URL 内の識別子です。

2. Database Password：

   • プロジェクト作成時に設定します。
   • または、Project Settings → Database で見つけることができます。

3. Access Token：

   • https://supabase.com/dashboard/account/tokens で生成します。

4. Service Role Key：

   • Project Settings → API → Project API keys で見つけることができます。

Cursor との統合

1. Cursor を開きます。
2. Settings → Features → MCP Servers に移動します。
3. 新しいサーバー設定を以下のように追加します。

名前：supabase
タイプ：command
コマンド：C:\Users\<usuario>\.local\bin\supabase-mcp-server.exe

実行ファイルの正確なパスを見つけるには、以下を実行します。

where.exe supabase-mcp-server

検証

ステップ 1：インストールの検証

ターミナルを開き、以下を実行します。

supabase-mcp-server

エラーメッセージが表示されなければ、インストールは成功しています。

ステップ 2：設定の検証

すべての環境変数が正しく設定されていることを確認し、サーバーが実行中であることを確認します。

トラブルシューティング

• サーバーが起動しない場合は、ログファイルを確認して詳細を取得してください。
• すべての環境変数が正しく設定されていることを確認してください。
• システムに必要な権限があることを確認してください。

リソース

• Supabase MCP Server の公式リポジトリ
• Supabase ドキュメント
• Supabase コミュニティ

サポート

インストール中に問題が発生した場合は、以下の手順を行ってください。

1. サーバーのログを確認します。
2. すべての環境変数が正しく設定されていることを確認します。
3. システムに必要な権限があることを確認します。
4. GitHub の Issues セクションを参照します。