Supabase MCP Server Zdf

🚀 Supabase MCP サーバー

Supabase MCP（管理制御プレーン）サーバーは、Cursor の Composer と Codeium の Cascade を通じてデータベース管理を行うためのツールです。表、レコード、インデックス、関数、セキュリティなど、完全なデータベース管理機能を提供し、自然言語による制御もサポートしています。

🚀 クイックスタート

Supabase MCP サーバーを使用するには、まずインストールと設定を行う必要があります。以下の手順に従ってサーバーを起動し、データベース管理を始めましょう。

✨ 主な機能

コア機能

• 自然言語制御：簡単な会話形式の指令で Supabase データベースを管理できます。
• 全面的なカバレッジ：表、レコード、インデックス、関数、セキュリティなど、あらゆるデータベース管理ツールを網羅しています。
• シームレスな統合：Cursor の Composer と Codeium の Cascade 内で直接使用できます。

具体的な機能

表管理

• すべての表を表示
• 新しい表を作成
• 表を削除
• 表構造を変更

レコード管理

• レコードを挿入
• レコードを照会
• レコードを更新
• レコードを削除

インデックス管理

• インデックスを追加
• インデックスを削除
• インデックスを変更

関数とストアドプロシージャ

• 関数を作成
• 関数を削除
• 関数を呼び出す

セキュリティ

• ユーザー権限を管理
• アクセス制御を設定
• 監査ログを管理

📦 インストール

プロジェクト構造

supabase-mcp-server/
├── dist/                    # コンパイル後の JavaScript ファイル
│   ├── index.d.ts          # TypeScript 宣言ファイル
│   └── index.js            # メイン JavaScript ファイル
├── src/                    # ソースコード
│   └── index.ts           # メイン TypeScript ファイル
├── package.json           # プロジェクト設定ファイル
├── package-lock.json      # 依存関係ロックファイル
└── tsconfig.json         # TypeScript 設定ファイル

インストール手順

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

git clone https://github.com/Quegenx/supabase-mcp-server.git
cd supabase-mcp-server

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

npm install

3. プロジェクトをコンパイルします：

npm run build

📚 ドキュメント

サーバーの起動

1. Node.js と npm がインストールされていることを確認します。
2. プロジェクトのルートディレクトリで以下のコマンドを実行してサーバーを起動します：

node dist/index.js [connection-string]

接続文字列の例

postgresql://[email]:password@localhost:5432/dbname

環境変数の設定

データベース接続情報を環境変数に保存することができます：

export DB_USER='your-database-user'
export DB_PASSWORD='your-database-password'
export DB_HOST='localhost'
export DB_PORT=5432
export DB_NAME='your-database-name'

node dist/index.js

MCP サーバーの設定

1. Cursor の Composer で、MCP 設定にアクセスします。
2. 新しい MCP プロバイダーを追加します：
   • 名前：Supabase Database
   • タイプ：Executable
   • コマンド：node dist/index.js
   • パラメータ：--connection-string [email]:password@localhost:5432/dbname

サーバーの起動（オプション）

ローカルで MCP サーバーを起動する場合は、以下のコマンドを実行します：

node dist/index.js --start-server

💻 使用例

基本的な使用法

上記のインストールと設定手順に従って、Supabase MCP サーバーを起動し、Cursor の Composer または Codeium の Cascade でデータベース管理を行います。

高度な使用法

自動化スクリプト

データ移行、バックアップと復元、パフォーマンス監視など、複雑なデータベースタスクを自動化するスクリプトを作成できます。

拡張プラグイン

コミュニティが提供する拡張プラグインを使用して、グラフィカルなインターフェイス、他のサービスとの統合、カスタムコマンドなどの機能を追加できます。

🔧 技術詳細

セキュリティに関する注意事項

1. データベース接続文字列を安全に保管する
2. 機密情報をバージョン管理システムにコミットしない
3. 適切な認証と承認ポリシーを使用する
4. すべての入力を検証し、クリーニングして SQL インジェクションを防止する

トラブルシューティング

一般的な接続問題

1. Node.js のパス問題

   • 正しい Node.js のパスを使用することを確認します。
   • Mac/Linux では、which node を使用して正しいパスを取得します。
   • Windows では、where node を使用して正しいパスを取得します。
   • /usr/local/bin/node を実際の Node.js のパスに置き換えます。

2. ファイルパス問題

   • 相対パスではなく絶対パスを使用します。
   • Mac/Linux では、プロジェクトディレクトリで pwd を使用して完全なパスを取得します。
   • Windows では、cd を使用して完全なパスを取得します。
   • 例：/Users/username/projects/supabase-mcp-server/dist/index.js

3. MCP がツールを検出できない場合

   • Cursor の MCP 設定のリフレッシュボタンをクリックします。
   • サーバーが正常に動作し、エラーメッセージがないことを確認します。
   • 接続文字列が正しいことを確認します。
   • Supabase の資格情報を検証します。

4. ポートの競合

   • 使用するポートが他のアプリケーションによって使用されていないことを確認します。
   • 別のポートを試してみます。

ログとデバッグ

1. 詳細なログ記録を有効にするには、以下のコマンドを実行します：

DEBUG=* node dist/index.js

2. サーバーの出力を確認して詳細情報を取得します。

ベストプラクティス

1. 定期的なバックアップ：データベースを定期的にバックアップして、万が一の場合に備えます。
2. アクセス制御：データベースへのアクセス権限を厳格に制限します。
3. パフォーマンス監視：データベースのパフォーマンスを継続的に監視し、必要に応じて最適化します。
4. 依存関係の更新：定期的にプロジェクトの依存関係を確認し、最新の機能とセキュリティパッチを取得します。

🔗 コミュニティとサポート

フォーラムとディスカッショングループ

• Supabase フォーラム
• Cursor ディスカッショングループ

ドキュメントとチュートリアル

• 公式ドキュメント
• 学習チュートリアル

🤝 貢献と開発

貢献の方法

1. 問題と提案を投稿する：
   • リポジトリ：GitHub 問題追跡
2. プルリクエストを送信する：
   • リポジトリを Fork します。
   • 変更を加えます。
   • プルリクエストを作成します。

開発ガイド

1. リポジトリをクローンし、サブモジュールを初期化します：

git clone https://github.com/Quegenx/supabase-mcp-server.git
cd supabase-mcp-server
git submodule update --init --recursive

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

npm install

3. 開発サーバーを起動します：

npm run dev

📄 ライセンス

このプロジェクトは MIT ライセンスの下で公開されており、自由な使用、変更、配布が許可されています。

Supabase MCP サーバーを使用することで、より効率的にデータベースを管理し、統合された開発体験を楽しむことができます。詳細については、公式ドキュメントを参照するか、コミュニティのディスカッションに参加してください。