MCP para bases de datos: PostgreSQL, MySQL y SQLite

Por qué conectar tu base de datos a Claude Code

Interactuar con bases de datos via MCP transforma tu flujo de desarrollo. En vez de escribir SQL manualmente, describes lo que necesitas en lenguaje natural y Claude Code genera y ejecuta la query.

Casos de uso principales:

• Exploración: "Muéstrame las 10 tablas más grandes y cuántas filas tiene cada una"
• Debugging: "Por qué esta query es lenta? Analiza el EXPLAIN y sugiere índices"
• Migraciones: "Añade una columna email_verified a la tabla users con default false"
• Análisis: "Cuántos usuarios se registraron por mes en los últimos 6 meses?"

Supabase MCP: el más completo

Si usas Supabase, su MCP es la mejor opción. Incluye funcionalidades que van más allá de SQL puro:

• execute_sql: Ejecutar cualquier query SQL
• list_tables: Listar todas las tablas con schema
• apply_migration: Aplicar migraciones SQL
• get_logs: Consultar logs del proyecto
• get_advisors: Obtener recomendaciones de rendimiento
• list_extensions: Listar extensiones PostgreSQL instaladas
• deploy_edge_function: Desplegar edge functions

Tutorial completo en MCP + Supabase: tutorial paso a paso.

PostgreSQL genérico

Para cualquier PostgreSQL (no solo Supabase), existen MCPs genéricos que se conectan via connection string.

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-postgres"],
      "env": {
        "DATABASE_URL": "postgresql://user:pass@host:5432/dbname"
      }
    }
  }
}

Operaciones: queries SELECT/INSERT/UPDATE/DELETE, inspección de esquema, generación de migraciones. Sin las funcionalidades extra de Supabase (logs, advisors, edge functions).

MySQL con MCP

MySQL tiene MCPs comunitarios disponibles. La configuración es similar al de PostgreSQL, cambiando el connection string al formato MySQL.

Funcionalidades: queries, inspección de esquema, migraciones. Menos maduro que el ecosistema PostgreSQL en MCP.

SQLite: desarrollo local

SQLite es ideal para desarrollo local y prototipos. El MCP opera sobre archivos .db locales sin necesidad de servidor.

{
  "mcpServers": {
    "sqlite": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-sqlite"],
      "env": {
        "DB_PATH": "./data/local.db"
      }
    }
  }
}

Ventaja: no necesita autenticación ni red. Claude Code lee y escribe directamente en el archivo .db.

Comparativa: cuál usar

Generar migraciones con IA

Uno de los usos más potentes: pedir a Claude Code que genere migraciones.

Ejemplo: "Analiza el esquema actual. Necesito añadir multi-tenancy con una columna organization_id en las tablas users, projects y invoices. Genera la migración con foreign keys y un índice."

Claude Code inspecciona el esquema con list_tables, genera el SQL de migración, te lo muestra para revisar, y puede aplicarlo con apply_migration (Supabase) o execute_sql.

Seguridad en producción

• Tokens de solo lectura: Para producción, configura un usuario de base de datos con permisos SELECT only. Nunca des permisos de escritura a un MCP en producción.
• Separate configs: Usa .claude/settings.json (por proyecto) para desarrollo y el global para defaults seguros.
• Connection strings: Nunca en código. Siempre variables de entorno.
• Backups: Antes de migraciones destructivas, verifica que tienes un backup reciente.
• Allowlists: Usa --allowedTools en Claude Code para limitar qué operaciones puede hacer en cada entorno.

Más detalles en seguridad en MCP: mejores prácticas.

Preguntas frecuentes

Puedo conectar PostgreSQL a Claude Code?

Sí. Mediante Supabase MCP o un MCP genérico de PostgreSQL con connection string.

Es seguro ejecutar queries desde Claude Code?

Para producción, usa tokens de solo lectura. Para desarrollo, puedes dar más permisos. Revisa siempre las queries destructivas.

Supabase MCP vs PostgreSQL genérico?

Supabase incluye logs, advisors, edge functions. El genérico solo SQL. Si usas Supabase, usa su MCP.

Puedo usar SQLite con Claude Code?

Sí. Opera sobre archivos .db locales. Ideal para desarrollo y prototipos.

Claude Code puede generar migraciones?

Sí. Analiza el esquema actual, propone cambios y genera SQL. Siempre revisa antes de ejecutar.