supabase-automation

Supabase Automation - Claude 数据库自动化管理技能

技能概述

通过 Composio 的 Rube MCP 在 Claude 中自动化管理 Supabase 数据库、表结构、项目配置、存储桶和边缘函数，无需切换工具即可完成查询、监控和运维操作。

适用场景

1. 数据库查询与维护

需要快速查询 Supabase 表数据、检查表结构、执行 SQL 更新或批量操作时，直接在 Claude 对话中完成，无需登录 Supabase Dashboard 或编写脚本。

2. 项目运维与监控

需要检查 Supabase 项目服务健康状态、查看 API 配置、监控数据库分支或管理组织成员时，通过该技能一键获取所有关键信息。

3. 开发工作流集成

在开发过程中需要生成 TypeScript 类型、检查存储桶列表、查看 Edge Functions 状态时，将该技能集成到开发流程中，提升开发效率。

核心功能

1. 数据库查询与操作

使用 PostgREST 过滤器（eq、gt、like、cs 等）进行精确数据查询，支持分页、排序和嵌套字段选择。对于复杂操作，可直接执行 SQL 语句，支持 INSERT、UPDATE、DELETE 等 DML 操作。

2. 表结构与 Schema 管理

列出所有表和视图，获取详细列类型、约束和关联关系，自动生成 TypeScript 类型定义。适合在开发前了解数据库结构，或为前端代码生成类型。

3. 项目与组织管理

列出所有组织和项目，获取数据库和认证配置，检查服务健康状态（auth、db、storage 等），查看 Edge Functions 和存储桶列表，一站式管理 Supabase 资源。

常见问题

如何在 Claude 中连接 Supabase？

首先需要配置 Rube MCP 服务器（添加 https://rube.app/mcp 到你的 MCP 配置），然后在对话中调用 RUBE_MANAGE_CONNECTIONS 选择 supabase 工具包。如果连接未激活，会返回认证链接，完成后即可使用所有 Supabase 功能。

如何获取 Supabase 项目的 project_ref？

使用 SUPABASE_LIST_ALL_PROJECTS 列出所有项目，每个项目都有一个 ref 字段，这是 20 位小写字母组成的项目引用（格式如 abcdefghijklmnopqrst），在查询表、执行 SQL 等操作时都需要使用此 ref。

Supabase MCP 技能支持哪些操作？

支持数据库查询（SELECT）、SQL 执行、表结构查询、项目配置查看、组织成员管理、服务健康检查、Edge Functions 列表、存储桶列表、TypeScript 类型生成等。大部分操作为只读，写操作需要通过 SQL 执行。

如何使用 PostgREST 过滤器查询数据？

调用 SUPABASE_SELECT_FROM_TABLE 时，在 filters 参数中指定 column、operator 和 value。常用操作符包括 eq（等于）、neq（不等于）、gt/gte（大于/大于等于）、like/ilike（模糊匹配）、in（包含于列表）、cs（数组包含）等。

Supabase 自动化能执行 SQL 写操作吗？

可以。使用 SUPABASE_BETA_RUN_SQL_QUERY 执行任意 SQL 语句，包括 INSERT、UPDATE、DELETE 等 DML 操作。建议对 SELECT 查询设置 read_only: true 以提高安全性。注意 SQL 执行有约 60 秒超时限制。

project_ref 格式是什么？

project_ref 是 Supabase 项目的唯一标识符，由恰好 20 位小写英文字母组成（a-z），不包含数字或连字符，格式如 ^[a-z]{20}$。如果格式错误会导致 API 调用失败。