MCP Supabase

Supabase MCPサーバーは、SupabaseプロジェクトとAIアシスタント（Cursor、Claudeなど）をつなぐツールで、Model Context Protocol標準を通じてAIアシスタントが直接データベーステーブルを管理し、データをクエリするなどの機能を実現します。

開発者ツールデータベース #データベース接続 #AI統合 #プロジェクト管理 .TypeScript

rating : 2 points

downloads : 16

update time : 2025-04-28

Supabase MCPサーバーとは？

Supabase MCPサーバーは、Model Context Protocol（MCP）に基づくミドルウェアサービスで、AIアシスタント（Cursor/Claudeなど）があなたのSupabaseプロジェクトと安全にやり取りできるようにします。標準化されたインターフェースを通じて、AIはデータベースクエリの実行、テーブル構造の管理、エッジ関数のデプロイなどの操作を行うことができ、データベースの認証情報を直接公開する必要はありません。

Supabase MCPサーバーの使い方は？

AIクライアントでサーバー起動コマンドを設定し、Supabaseの個人アクセストークンを提供するだけです。サーバーは複数のセキュリティモードをサポートしており、プロジェクト分離と読み取り専用モードを含み、AIアシスタントが許可された範囲内でのみ操作できるようにします。

適用シーン

開発支援（自動SQL/型定義生成）、本番環境監視（ログクエリ）、チーム協力（ブランチ管理）などのシーンに適しており、AIによるデータベース開発が必要なチームに特に適しています。

主な機能

プロジェクト管理Supabaseプロジェクトの表示/作成/一時停止、組織情報の取得（アカウントレベルの権限が必要）

データベース操作SQLクエリの実行、テーブル構造の変更管理、拡張機能とマイグレーション記録の表示

エッジ関数エッジ関数のデプロイと管理、JavaScript/TypeScriptコードをサポート

ブランチ管理（実験的）開発ブランチの作成、変更のマージ、マイグレーションの競合解消（有料プランが必要）

型生成自動でTypeScript型定義を生成し、フロントエンド開発を容易にする

利点と制限

利点

標準化されたインターフェース：MCPプロトコルを通じてAIとSupabaseのやり取り方法を統一する

細かい権限制御：プロジェクト分離と読み取り専用モードをサポートし、セキュリティを保障する

開発効率：AIが繰り返しのデータベース操作を自動で行うことができる

複数のクライアントサポート：Cursor/Claudeなどの主流のAI開発ツールと互換性がある

制限

プレリリース段階：1.0バージョン前はインターフェースの変更がある可能性がある

Windows互換性：PATH環境変数を追加設定する必要がある

ブランチ機能：実験的な機能で、有料プランのサポートが必要

使い方

アクセストークンの取得

Supabaseダッシュボードの[アカウント設定→トークン]ページで個人アクセストークン（PAT）を作成します。

クライアントの設定

AIアシスタントの設定にMCPサーバーの起動コマンドを追加します（例は右側を参照）。

セキュリティモード（オプション）

--project - refを追加してプロジェクト範囲を制限するか、--read - onlyを使用して読み取り専用モードを有効にします。

使用例

データベース設計支援AIが自然言語の説明に基づいて自動的にデータテーブル構造を作成します。

本番問題診断最近のエラーログをクエリしてAPIのパフォーマンス問題を分析します。

型安全開発自動的にフロントエンドのTypeScript型定義を生成します。

よくある質問

アクセストークンが漏洩したらどうしたらいいですか？

Windowsシステムでサーバーが起動しません。どうすればいいですか？

変更コストを確認するにはどうすればいいですか？

AIはどのようなSQL操作ができますか？

🚀 Supabase MCP サーバー

Supabase MCP サーバー は、大規模言語モデル (LLM) が人工的な介入なしに直接 Supabase プロジェクトとやり取りできるようにします。Model Context Protocol (MCP) を通じて、LLM は安全に複雑なデータベース操作、エッジ関数の管理、プロジェクト設定の構成などを実行できます。

🚀 クイックスタート

📦 インストール

依存関係のインストール

Node.js と npm がインストールされていることを確認してください。

npm install -g node

API キーの取得

Supabase プロジェクトから anon 公開キーと管理キーを取得します。

サーバーの起動

ターミナルで以下のコマンドを実行して、MCP サーバーを起動します。

npx supabase-mcp-server --anon-key=your_anon_key --api-key=your_api_key

⚠️ 注意事項

⚠️ 重要提示

このサーバーは pre-1.0 段階であり、いくつかの破壊的な変更がある可能性があります。ただし、LLM は利用可能なツールに自動的に適応するため、ほとんどのユーザーには影響が少ないです。

💡 使用建议

generate_typescript_types ツールを使用すると、データベーススキーマに基づく TypeScript 型を生成できます。LLM はこれらの型をファイルに保存し、コードで使用することができます。

✨ 主な機能

利用可能なツール

以下は、LLM が使用できる Supabase ツールのリストです。

プロジェクト管理

注意：サーバーが特定のプロジェクトにスコープされている場合、以下のツールは使用できません。

list_projects：ユーザーのすべての Supabase プロジェクトをリストします。
get_project：指定されたプロジェクトの詳細情報を取得します。
create_project：新しい Supabase プロジェクトを作成します。
pause_project：指定されたプロジェクトを一時停止します。
restore_project：一時停止されたプロジェクトを復元します。
list_organizations：ユーザーが所属するすべての組織をリストします。
get_organization：指定された組織の詳細情報を取得します。

データベース操作

list_tables：特定のスキーマ内のすべてのテーブルをリストします。
list_extensions：データベース内のすべての拡張機能をリストします。
list_migrations：データベース内のすべてのマイグレーションをリストします。
apply_migration：SQL マイグレーションをデータベースに適用します。LLM は DDL 操作（スキーマ変更）にこのツールを使用する必要があります。
execute_sql：データベースの生の SQL クエリを実行します。LLM は通常のクエリでスキーマを変更しない場合にこのツールを使用する必要があります。
get_logs：サービスタイプに基づいて Supabase プロジェクトのログ（api、postgres、エッジ関数、認証、ストレージ、リアルタイム）を取得します。LLM はこのツールを使用して、サービスのデバッグとパフォーマンス監視を行うことができます。

エッジ関数管理

list_edge_functions：プロジェクト内のすべてのエッジ関数をリストします。
deploy_edge_function：新しいエッジ関数を Supabase プロジェクトにデプロイします。LLM はこのツールを使用して、新機能をデプロイしたり、既存の機能を更新したりすることができます。