Quegenx Supabase MCP Server

🚀 Supabase MCP サーバー

この Supabase MCP サーバーは、Cursor や Codeium の Composer との統合に特化して開発され、包括的なデータベース管理機能を提供します。自然言語での操作が可能で、データベース管理を大幅に簡素化します。

🚀 クイックスタート

📦 インストール

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

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

2. プロジェクトディレクトリに移動します：

cd supabase-mcp-server

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

npm install

4. コードをコンパイルします：

npm run build

🚀 サービスの起動

コンパイルが完了したら、以下のコマンドで MCP サーバーを起動します：

node dist/index.js [postgresql://...] 

[postgresql://...] をあなたの Supabase データベースの接続文字列に置き換えてください。

✨ 主な機能

この MCP サーバーは、Cursor と Codeium の Composer との統合に特化して設計され、包括的なデータベース管理機能を提供します。以下の操作がサポートされています：

• テーブルの作成と削除
• ユーザーデータの管理
• インデックスの操作
• SQL クエリの実行
• リアルタイム通信チャネルの管理
• ユーザー認証

📚 ドキュメント

📁 プロジェクト構造

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

💻 使用例

基本的な使用法

MCP サーバーが起動した後、Cursor の Composer で自然言語を使ってデータベースを操作できます。例えば：

• "すべてのデータベーステーブルを表示"
• "id、名前、メールアドレスのフィールドを持つ新しいユーザーテーブルを作成"

高度な使用法

基本的な CRUD 操作に加え、このサーバーは以下のような複雑なデータベース管理タスクもサポートしています：

• リアルタイムデータフローの管理
• カスタム SQL クエリの実行
• ユーザー権限の設定と変更

🚀 主な利点

• 直感的な操作：自然言語処理技術により、データベース操作を簡素化
• 包括的な機能：テーブル、インデックス、関数、セキュリティなど、多方面をカバー
• シームレスな統合：Cursor と Codeium で直接使用可能
• 開発者にやさしい：IDE とデータベースツール間の切り替えを減らす
• 安全で信頼性高い：データベースアクセスのセキュリティを確保

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

• 接続文字列の保護：機密情報を外部に公開しないようにしてください。
• 権限管理：厳格なアクセス制御ポリシーを設定しましょう。
• 入力検証：SQL インジェクション攻撃を防ぐため、入力を検証します。

🚨 よくある問題の解決策

1. 起動失敗の問題

• Node.js が正しくインストールされ、PATH 環境変数に追加されていることを確認してください。
• package.json と package-lock.json ファイルが存在することを確認してください。

2. データベース接続失敗の問題

• データベースサービスが実行中で、ネットワークからアクセス可能であることを確認してください。
• 接続文字列の形式と情報が正しいことを検証してください。

🌟 コントリビューションガイド

コミュニティからのコード貢献を歓迎します！コードを提出するか、提案をする場合は、CONTRIBUTING.md ファイルを参照してください。

📄 ライセンス

このプロジェクトは MIT ライセンスに基づいています。詳細は LICENSE ファイルをご覧ください。