supabase-automation

Supabase Automation 是一个基于 Rube MCP（Composio）的自动化技能，用于通过 Supabase 工具集执行数据库与项目相关操作。

【用途】 该技能面向需要自动化操作 Supabase 的场景，包括数据库查询、表管理、项目与组织管理、存储、边缘函数以及 SQL 执行。

【前置要求】

• 必须已连接 Rube MCP（RUBE_SEARCH_TOOLS 可用）。
• 需通过 RUBE_MANAGE_CONNECTIONS 建立活跃的 Supabase 连接（工具包为 supabase）。
• 每次应先调用 RUBE_SEARCH_TOOLS 获取当前工具模式。

【设置方式】

1. 获取 Rube MCP：在客户端配置中将 https://rube.app/mcp 添加为 MCP 服务器，无需 API 密钥。
2. 确认 RUBE_SEARCH_TOOLS 可用。
3. 调用 RUBE_MANAGE_CONNECTIONS（工具包 supabase）。
4. 若连接非 ACTIVE，按返回的认证链接完成 Supabase 认证。
5. 确认连接状态为 ACTIVE 后再执行工作流。

【主要能力】

1. 查询与管理数据库表：可列出项目、列出表和视图、获取表结构、查询行数据（支持过滤、排序、分页），以及通过 SQL 查询执行复杂查询和写入操作。查询工具为只读，写入需使用 SQL 执行工具。
2. 管理项目与组织：可列出组织、获取组织信息、列出成员、列出项目、获取 Postgres 配置、认证配置、API 密钥（敏感）以及服务健康状态。
3. 检查数据库结构：可列出表、获取详细表结构，并基于模式生成 TypeScript 类型。
4. 管理边缘函数：可列出所有边缘函数并获取特定函数的详细信息，但仅为只读检查工具，不能创建或部署函数。
5. 管理存储桶：可列出所有存储桶，但不会返回桶内内容或访问策略。

【关键参数与注意事项】

• 项目引用（project_ref）必须为 20 位小写字母。
• SQL 查询工具支持 read_only 参数以强制只读事务。
• 查询表时支持 PostgREST 过滤操作符，如 eq、neq、gt、gte、lt、lte、like、ilike、is、in、cs、cd 及全文搜索变体。
• PostgreSQL 数组列需使用 ARRAY['item1', 'item2'] 或 '{"item1", "item2"}' 语法，而非 JSON 数组语法。
• 大小写敏感的标识符在 SQL 中需用双引号。
• 复杂 DDL 操作可能超时（约 60 秒），建议拆分为较小查询。
• 常见错误：42P01 关系不存在通常因未加引号的大小写敏感标识符；42883 函数不存在建议改用 information_schema。
• API 密钥工具返回实时密钥，切勿记录、显示或持久化完整值。
• 服务健康状态需要非空的服务数组。
• 配置工具可能因令牌权限不足返回 401/403，应优雅处理。

【适用场景】 适用于需要自动化执行 Supabase 数据库操作、检查结构、生成类型、查看项目和组织信息、检查边缘函数与存储桶的开发和运维流程。

【限制】

• 边缘函数相关工具为只读，无法创建或部署。
• 存储桶工具仅列出桶，不提供桶内容或访问策略。
• 部分工具可能受权限或分页限制。
• 资料未提供收费、价格或具体平台限制信息。