SuperAPI AI 工具集

mcp-supabase

数据与分析

查看项目

更新于 10-15 22:13

技能介绍

用途:通过 Supabase MCP 工具与 Supabase 数据库交互,执行查询、写入、迁移(DDL)、诊断、类型生成与日志/建议查看。适用于对 Supabase 做数据库侧操作,不适用于在 Next.js 项目中完成集成实现。project 侧集成由 workflow-ship-faster 处理,本技能作为其 DB 操作基础,负责 DB 侧动作与安全门禁。

主要能力:工具包括 list_tables、execute_sql、apply_migration、list_migrations、generate_typescript_types、get_project_url、get_publishable_keys、get_logs、get_advisors;可选启用时含 Edge Functions(list_edge_functions、get_edge_function、deploy_edge_function)与分支(create_branch、list_branches、merge_branch、reset_branch、rebase_branch、delete_branch)。

安全规则:操作前先查 schema;SELECT 默认 LIMIT 50,除非用户明确要求更多;INSERT/UPDATE/DELETE 执行前须展示 SQL、说明预计影响行数并等待明确确认;无 WHERE 的 UPDATE/DELETE 直接拒绝;影响超过 100 行需二次确认并建议先 SELECT count(*);DDL 必须通过 apply_migration,不能直接用 execute_sql;生产环境默认禁用写操作,仅在用户明确要求并二次确认后允许;email/phone/token/password 等敏感字段默认掩码或不返回。

使用方式:解析需求并复述目标,不确定表/字段时先 list_tables 或查 information_schema;展示计划 SQL;只读直接执行;写入确认后执行并核对影响行数。多步骤工作流可把上下文落盘,仅传路径,目录如 runs/<workflow>/active/<run_id>/,含 01-input、03-plans、05-final、logs。输出结构为结论→关键数字→执行 SQL→结果表(最多 50 行),超限截断并显示总数。

适用场景:查询/统计/导出、确认后的写入、迁移、类型生成、查询日志与 advisors。

限制:写入需用户确认,生产写默认禁用,危险无 WHERE 写被拒绝;schema 参考可能过时,应以 information_schema 或 generate_typescript_types 为准。另可配合 supabase/references/postgres-best-practices/ 下的 Postgres 最佳实践读取,变更需引用对应规则文件路径并保持最小化。