SB MCP

🚀 Supabase MCP サーバー

このサーバーは、モデルコンテキストプロトコル（MCP）を使用して、Claudeやその他の大規模言語モデルがSupabaseと相互作用し、PostgresテーブルのCRUD操作を実行できるようにします。

✨ 主な機能

• データベース操作:
  • フィルターを使用したデータのクエリ
  • データの挿入
  • データの更新
  • データの削除
  • テーブルの一覧表示

📦 インストール

オプション1：npmを通じたインストール（推奨）

このパッケージはnpmに公開されています。グローバルにインストールすることができます。

npm install -g supabase-mcp

または、あなたのプロジェクト内にローカルインストールすることもできます。

npm install supabase-mcp

オプション2：リポジトリのクローン

git clone https://github.com/Cappahccino/SB-MCP.git
cd SB-MCP
npm install
npm run build

📚 ドキュメント

前提条件

• Node.js（v16以上）
• npmまたはyarn
• APIキー付きのSupabaseプロジェクト

設定

プロジェクトのルートディレクトリに mcp.json という名前のファイルを作成し、以下の内容を追加します。

{
  "supabase": {
    "url": "YOUR_SUPABASE_URL",
    "anonKey": "YOUR_SUPABASE_ANON_KEY"
  }
}

YOUR_SUPABASE_URL と YOUR_SUPABASE_ANON_KEY を、あなたの実際のSupabaseプロジェクトのURLと匿名キーに置き換えてください。

使用方法

独立したサーバーとして

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

node index.js

他のプロジェクトへの統合

あなたのプロジェクトでこのパッケージをインポートして使用します。

const { MCP } = require('supabase-mcp');
const mcp = new MCP();

// データのクエリ
mcp.query('your-supabase-project-id', {
  query: {
    table: 'users',
    where: {
      id: 1
    }
  },
  response: {
    format: 'json'
  }
}).then(console.log);

// データの挿入
mcp.execute('your-supabase-project-id', {
  command: 'insert',
  data: { name: 'Alice' },
  query: {
    table: 'users'
  }
});

トラブルシューティング

一般的な問題と解決策

• 問題：Supabaseへの接続ができない
  • mcp.json でプロジェクトのURLとキーが正しく設定されていることを確認してください。
• 問題：クエリが空の結果を返す
  • フィルターが正しいことを確認し、テーブル名が存在することを確認してください。

ツールリファレンス

データベース操作コマンド

データのクエリ

{
  "command": "query",
  "project_id": "your-supabase-project-id",
  "data": {
    "table": "users",
    "where": { "id": 1 }
  },
  "response": { "format": "json" }
}

データの挿入

{
  "command": "insert",
  "project_id": "your-supabase-project-id", 
  "data": {
    "table": "users",
    "values": { name: 'Alice' }
  }
}

バージョン履歴

• 1.0.0：初期リリース
• 1.0.1：自動ポート選択の追加
• 1.0.2：プロトコル互換性の問題の修正
• 1.0.3：JSON-RPCサポートの追加
• 1.1.0：公式MCP SDKとして完全に書き換え
• 1.2.0：独立したClaudeトランスポートの追加とポート競合問題の修正
• 1.3.0：TypeScriptプロジェクトとの互換性向上のための更新
• 1.4.0：Supabaseコミュニティのベストプラクティスに基づくClaude標準入出力統合の修正
• 1.5.0：Edge Functionサポートの削除、データベース操作の安定性に注力

📄 ライセンス

MIT