pinion05-supabase-mcp-lite

Supabase MCP Lite

最小構成の Supabase MCP サーバー。標準的な実装と比べて、コンテキストの使用量を70％削減します。

Lite を選ぶ理由

• ツールは50個以上ではなく4個 - 必要な操作だけを用意
• 最小限の説明 - 冗長な説明はありません
• シンプルなパラメーター - 複雑なネストされたスキーマはありません
• 結果を自動で切り詰め - クエリごとに最大100行

🔑 パーソナルアクセストークンが必要です

この MCP は、お客様が所有する任意のプロジェクトのサービスロールキーを自動取得するために、Supabase パーソナルアクセストークン（sbp_で始まるもの）を使用します。

パーソナルアクセストークンの取得方法：

1. https://supabase.com/dashboard/account/tokens にアクセスします
2. 「Generate New Token」をクリックします
3. 名前を付けます（例：「MCP Access」）
4. トークンをコピーします（sbp_で始まります）
5. 安全な場所に保存してください - 再度表示することはできません！

セットアップ

1. MCP クライアントの設定に追加します：

{
  "supabase-lite": {
    "command": "npx",
    "args": ["@smithery/cli", "connect", "@pinion05/supabase-mcp-lite"],
    "config": {
      "accessToken": "sbp_xxxxxxxxxxxx"  // Your Personal Access Token
    }
  }
}

注：各ツール呼び出しでプロジェクト URL が必要です。サービスロールキーはアクセストークンを使用して自動取得されます。

ツール（4個）

すべてのツールで、最初のパラメーターとしてprojectUrlが必要です。

ツール	用途	パラメーター
select	データの取得	projectUrl, table, where?, limit?
mutate	データの変更	projectUrl, action, table, data?, where?
storage	ファイル	projectUrl, action, bucket, path?, data?
auth	ユーザー	projectUrl, action, email?, password?, id?

使用例

// Select tool  
select(
  projectUrl: "https://your-project.supabase.co",
  table: "posts", 
  where: {status: "published"}, 
  limit: 10
)

// Mutate tool
mutate(
  projectUrl: "https://your-project.supabase.co",
  action: "insert", 
  table: "todos", 
  data: {title: "New task"}
)
mutate(
  projectUrl: "https://your-project.supabase.co",
  action: "update", 
  table: "todos", 
  data: {done: true}, 
  where: {id: 1}
)
mutate(
  projectUrl: "https://your-project.supabase.co",
  action: "delete", 
  table: "todos", 
  where: {id: 1}
)

// Storage tool
storage(
  projectUrl: "https://your-project.supabase.co",
  action: "upload", 
  bucket: "images", 
  path: "avatar.jpg", 
  data: "base64..."
)
storage(
  projectUrl: "https://your-project.supabase.co",
  action: "list", 
  bucket: "images"
)

// Auth tool
auth(
  projectUrl: "https://your-project.supabase.co",
  action: "list"
)
auth(
  projectUrl: "https://your-project.supabase.co",
  action: "create", 
  email: "[email protected]", 
  password: "secure123"
)

仕組み

1. パーソナルアクセストークン（sbp_xxx）を指定します
2. プロジェクト URL を使ってツールを呼び出すと、MCP は次の処理を行います：
   • URL からプロジェクト ID を抽出します
   • アクセストークンを使用して、Supabase Management API 経由でサービスロールキーを取得します
   • 同じプロジェクトへの今後のリクエストに備えて、キーをキャッシュします
   • フル管理者アクセス権を持つクライアントを作成します

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

• パーソナルアクセストークンを使うと、所有するすべての Supabase プロジェクトにアクセスできます
• サービスロールキーは自動取得され、メモリにキャッシュされます
• サービスロールキーは Row Level Security（RLS）をバイパスします
• アクセストークンは安全に保管してください - クライアント側に決して公開しないでください
• このツールはサーバー側／管理者向けの用途に限られます

機能

• ✅ 所有する任意の Supabase プロジェクトで動作します
• ✅ サービスロールキーを自動取得します
• ✅ API 呼び出しを最小限に抑えるため、キーをキャッシュします
• ✅ データベースにフルアクセスできます（RLS をバイパス）
• ✅ 1つのセッションで複数のプロジェクトをサポートします

ライセンス

MIT