Supabase PostgreSQL

🚀 Supabase MCP サーバーの設定と使用方法

このプロジェクトは、Cursor と Codeium Cascade を通じて Supabase データベースを管理するための MCP（機械制御プロトコル）サーバーを提供します。自然言語コマンドを使用して、様々なデータベース操作を実行することができます。

🚀 クイックスタート

依存関係のインストール

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

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

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

npm install

3. プロジェクトをビルドします：

npm run build

設定

1. Supabase プロジェクト ID と Anon パブリックキー をコピーします。

2. .env ファイルを作成します：

echo "SUPABASE_PROJECT_ID=your_project_id" > .env
echo "SUPABASE_PUBLIC_KEY=your_anon_key" >> .env

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

npm start

✨ 主な機能

この MCP サーバーは、Cursor の Composer でデータベース管理ツールを提供します。自然言語でデータベース操作を記述するだけで、AI が適切なコマンドを実行します。

📦 インストール

依存関係のインストール

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

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

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

npm install

3. プロジェクトをビルドします：

npm run build

設定

1. Supabase プロジェクト ID と Anon パブリックキー をコピーします。

2. .env ファイルを作成します：

echo "SUPABASE_PROJECT_ID=your_project_id" > .env
echo "SUPABASE_PUBLIC_KEY=your_anon_key" >> .env

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

npm start

💻 使用例

基本的な使用法

設定が完了すると、MCP サーバーは Cursor の Composer でデータベース管理ツールを提供します。データベースに対して行いたい操作を記述するだけで、AI が適切なコマンドを実行します。

例：

• 📋 "データベース内のすべてのテーブルを表示して"
• ➕ "id、name、email 列を持つ新しいユーザーテーブルを作成して"
• 🔍 "users テーブルの email 列にインデックスを追加して"

📚 ドキュメント

プロジェクト構造

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

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

• 🔐 データベース接続文字列は安全に保管してください。
• ⚠️ 機密情報をバージョン管理システムにコミットしないでください。
• 👮 適切なアクセス制御と権限を使用してください。
• 🛡️ すべての入力を検証し、クリーニングして SQL インジェクションを防止してください。

トラブルシューティング

1. 環境変数の問題：

   • SUPABASE_PROJECT_ID と SUPABASE_PUBLIC_KEY が正しく設定されていることを確認してください。
   • .env ファイルが存在し、スペルミスがないことを確認してください。

2. 接続の問題：

   • ネットワークが Supabase サービスへのアウトバウンドを許可していることを確認してください（デフォルトポート：443）。
   • curl https://api.supabase.com/v1/anon を使用して接続をテストしてください。

3. 起動の問題：

   npm start -- --env development
   

   デバッグが必要な場合は、以下のコマンドを使用してください：

   DEBUG=supabase-mcp:* npm start
   

プラットフォーム固有の説明

1. Windows ユーザー：

   • Node.js がインストールされていることを確認してください。
   • コマンドをコマンドラインで実行してください。
   • .env ファイルをプロジェクトのルートディレクトリにコピーしてください。

2. macOS と Linux ユーザー：

   • 最新バージョンの Node.js を使用していることを確認してください。
   • xdg-open または open を使用して生成されたログファイルを開くことができます：

     xdg-open ./logs/server.log
     

📄 ライセンス

MIT License

🔗 連絡先

質問や提案がある場合は、GitHub Issues で問題を作成してください。