supabase-mcp-db
npx skills add https://github.com/santiagoxor/pintureria-digital --skill supabase-mcp-db
Agent 安装分布
Skill 文档
Supabase MCP: migraciones y base de datos
Cuándo usar esta skill
- El usuario pide aplicar migraciones (con MCP o “con tools mcp”).
- Pide gestionar la base de datos usando el MCP de Supabase.
- Necesitas listar migraciones aplicadas, ejecutar SQL o consultar esquema sin usar la CLI local.
Servidor MCP: user-supabase-SantiagoXOR. Usar call_mcp_tool con este server.
Aplicar una migración
-
Leer el SQL del archivo en
supabase/migrations/*.sql. -
Nombre en snake_case: usar el nombre del archivo sin fecha ni extensión (ej.
20260224100000_create_push_subscriptions.sqlâcreate_push_subscriptions). -
Llamar al MCP:
call_mcp_tool server: user-supabase-SantiagoXOR toolName: apply_migration arguments: { "name": "<snake_case_name>", "query": "<contenido SQL completo>" } -
Si falla por tipos en RLS (ej.
operator does not exist: text = uuid): en las polÃticas que usenauth.uid()o FKs, usar casts explÃcitos (auth.uid()::text,user_id::text IN (SELECT id::text FROM ...)). Corregir el archivo de migración en el repo y volver a aplicar.
Importante: Para DDL (CREATE TABLE, ALTER, polÃticas RLS, etc.) usar siempre apply_migration, no execute_sql.
Otras herramientas útiles del MCP
| Herramienta | Uso |
|---|---|
list_migrations |
Ver migraciones ya aplicadas en la DB (sin argumentos). |
execute_sql |
Ejecutar SELECT o DML (INSERT/UPDATE/DELETE). No usar para DDL; para eso usar apply_migration. |
list_tables |
Listar tablas del esquema (consultar descriptor en mcps/user-supabase-SantiagoXOR/tools/list_tables.json si hace falta). |
get_advisors |
Recomendaciones del proyecto Supabase. |
get_logs |
Logs del proyecto. |
Todas con call_mcp_tool, server: user-supabase-SantiagoXOR, toolName: <nombre>, arguments: { ... } según el descriptor en mcps/user-supabase-SantiagoXOR/tools/<nombre>.json.
Orden al aplicar varias migraciones
Aplicar en orden cronológico (por prefijo de fecha en el nombre del archivo). Si una falla, corregir y reaplicar solo esa antes de seguir.
Referencia
- Listado de herramientas y parámetros: reference.md.
- Antes de llamar una herramienta, leer el descriptor en
mcps/user-supabase-SantiagoXOR/tools/<toolName>.jsonpara argumentos requeridos.