pinion05-supabase-mcp-lite

Supabase MCP Lite

精简版 Supabase MCP 服务，所需上下文比标准实现减少 70%。

为什么选择 Lite？

• 仅提供 4 个工具，而非 50 多个——仅包含必要操作
• 描述精简——没有冗长的说明
• 参数简单——没有复杂的嵌套架构
• 结果自动截断——每次查询最多返回 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 项目
• 系统会自动获取服务角色密钥并将其缓存在内存中
• 服务角色密钥会绕过行级安全（RLS）
• 请妥善保管访问令牌——切勿在客户端暴露
• 此工具仅供服务端／管理员使用

功能

• ✅ 适用于你拥有的任意 Supabase 项目
• ✅ 自动获取服务角色密钥
• ✅ 缓存密钥，尽量减少 API 调用
• ✅ 完整的数据库访问权限（绕过 RLS）
• ✅ 支持在同一会话中使用多个项目

许可证

MIT