用途:通过 Supabase MCP 服务器 user-supabase-SantiagoXOR 应用迁移并管理数据库,适用于用户要求应用迁移、用 MCP 管理数据库,或需要列出已应用迁移、执行 SQL、查看表结构而不使用本地 CLI 的场景。
主要能力:apply_migration 应用迁移;list_migrations 查看已应用迁移;execute_sql 执行 SELECT 或 DML;list_tables 列出表;get_advisors 获取项目建议;get_logs 查看日志。所有操作均通过 call_mcp_tool 调用,server 为 user-supabase-SantiagoXOR,toolName 与 arguments 按 mcps/user-supabase-SantiagoXOR/tools/<toolName>.json 描述符填写。
使用方式:应用迁移时,先读取 supabase/migrations/*.sql 中的 SQL,迁移名用文件名去掉日期和扩展名的 snake_case 形式(如 20260224100000_create_push_subscriptions.sql → create_push_subscriptions),再调用 apply_migration,arguments 为 {"name":"<snake_case_name>","query":"<完整 SQL 内容>"}。DDL(CREATE TABLE、ALTER、RLS 策略等)必须用 apply_migration,不要用 execute_sql;execute_sql 仅用于 SELECT 或 DML。多个迁移按文件名日期前缀的时间顺序应用,失败时修正后仅重跑该迁移再继续。
限制与注意:若 RLS 出现类型错误(如 operator does not exist: text = uuid),需在策略中对 auth.uid() 或外键使用显式转换(auth.uid()::text、user_id::text IN (SELECT id::text FROM ...)),修正仓库中的迁移文件后重新应用。调用工具前应阅读对应描述符以确认必需参数。其他细节暂未提供。