MCPdir — MCP Server Directory
🇬🇧 🇪🇸

PostgreSQL MCP

by JaviMaligno

Consulta y explora bases de datos PostgreSQL a través de tu asistente de IA

database Python Intermedio Auto-hospedable Sin API key Verificado
📅 Actualizado: hace 3sem

Descripción

PostgreSQL MCP le da a tu asistente de IA acceso directo, orientado a lectura, a bases de datos PostgreSQL. En lugar de cambiar entre tu editor y un cliente de base de datos, puedes pedirle a tu IA que inspeccione estructuras de tablas, ejecute queries y explique planes de ejecución, todo dentro de la misma conversación donde estás escribiendo código. Esta integración directa entre exploración de base de datos y generación de código acelera drásticamente el desarrollo de la capa de datos. El server expone un conjunto enfocado de herramientas diseñadas alrededor de las tareas de base de datos más comunes durante el desarrollo. Tienes introspección de esquemas a través de `list_tables`, `list_schemas` y `describe_table`, que permiten a la IA entender tu modelo de datos antes de escribir cualquier query. La herramienta `query` ejecuta SQL y devuelve resultados formateados, mientras que `explain_query` muestra el plan de ejecución para que la IA pueda ayudarte a optimizar queries lentas con datos concretos en lugar de suposiciones. La seguridad se maneja a través del connection string que proporcionas al iniciar. El server se conecta a exactamente una base de datos con los permisos que ese connection string otorgue. Para flujos de trabajo de desarrollo, esto típicamente significa conectarse a una base de datos local o de staging. No hay restricción de escritura a nivel MCP, así que usa un usuario de base de datos de solo lectura si quieres asegurar que la IA no pueda modificar datos — una buena práctica que requiere solo un comando SQL para configurar.

✅ Ideal para

Desarrolladores backend que trabajan con PostgreSQL y quieren que su IA entienda y consulte el esquema real de su base de datos durante el desarrollo

⏭️ No recomendado si

Usas MySQL, SQLite u otra base de datos no-PostgreSQL — busca servers MCP específicos para tu base de datos o un MCP SQL genérico

💡 Casos de uso

  • Explorar esquemas de bases de datos desconocidos para entender relaciones de datos antes de escribir código de aplicación
  • Escribir e iterar queries SQL complejas con asistencia de IA, incluyendo análisis de planes de ejecución
  • Generar modelos ORM, migraciones o endpoints de API basándose en la estructura real de la base de datos

👍 Ventajas

  • La introspección directa de esquemas permite a la IA entender tu modelo de datos sin explicación manual
  • El análisis de planes de ejecución ayuda a optimizar queries lentas con datos concretos
  • Configuración simple por connection string — apúntalo a cualquier instancia PostgreSQL accesible

👎 Desventajas

  • Solo PostgreSQL — no compatible con MySQL, SQLite u otras bases de datos
  • Sin restricción de solo lectura integrada — necesitas usar un usuario de base de datos de solo lectura por seguridad

🔧 Herramientas expuestas (5 herramientas)

ToolCategoríaDescripción
queryqueryEjecutar una query SQL contra la base de datos PostgreSQL conectada y devolver los resultados
explain_queryqueryMostrar el plan de ejecucion de una query SQL para analizar rendimiento y oportunidades de optimizacion
list_tablesschema inspectionListar todas las tablas en la base de datos actual o en un esquema especifico
describe_tableschema inspectionMostrar las definiciones de columnas, tipos y restricciones de una tabla dada
list_schemasschema inspectionListar todos los esquemas disponibles en la base de datos PostgreSQL conectada

⚡ Instalación

Requisitos previos:

  • • python
claude mcp add postgres -- npx @anthropic-ai/postgres-mcp@latest postgresql://localhost:5432/mydb

💡 Consejos y trucos

Siempre conéctate con un usuario de base de datos de solo lectura en entornos similares a producción. Crea uno con: `CREATE ROLE readonly LOGIN PASSWORD 'pass'; GRANT CONNECT ON DATABASE mydb TO readonly; GRANT USAGE ON SCHEMA public TO readonly; GRANT SELECT ON ALL TABLES IN SCHEMA public TO readonly;`. Para desarrollo local, el superusuario por defecto está bien. Cuando le pidas a la IA que ayude a optimizar queries, haz que use `explain_query` primero para obtener el plan de ejecución real, y luego iterar sobre la query basándose en datos de rendimiento reales en lugar de suposiciones.

Info rápida

Autor
JaviMaligno
Licencia
Runtime
Python
Transporte
stdio
Categoría
database
Dificultad
Intermedio
Auto-hospedable
API key
No necesita API key
Docker
Versión
0.0.0
Actualizado
28 ene 2026

Compatibilidad con clientes

  • Claude Code
  • Cursor
  • VS Code Copilot
  • Gemini CLI
  • Windsurf
  • Cline
  • JetBrains AI
  • Warp

Plataformas

🍎 macOS 🐧 Linux 🪟 Windows