PostgreSQL MCP Server

Servidor MCP (Model Context Protocol) para acceso de solo lectura a bases de datos PostgreSQL.

Características

Este servidor MCP proporciona herramientas para:

• 📋 Listar tablas disponibles en la base de datos

• 🔍 Ver estructura completa de tablas (columnas, tipos, constraints, índices)

• 📊 Obtener estadísticas de tablas (filas, tamaño, última actualización)

• 🔎 Ejecutar queries SELECT de solo lectura (protegido contra operaciones de escritura)

Instalación

Configuración en Claude Desktop

Agrega la configuración del servidor MCP en tu archivo de configuración de Claude Desktop:

macOS

Edita: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows

Edita: %APPDATA%\Claude\claude_desktop_config.json

Configuración:

Importante: Reemplaza /ruta/absoluta/a/postgres-mcp con la ruta real donde clonaste el proyecto.

Herramientas Disponibles

1. list_tables

Lista todas las tablas en un schema.

Parámetros:

• schema (opcional): Nombre del schema (por defecto: 'public')

Ejemplo de uso:

2. describe_table

Muestra la estructura completa de una tabla.

Parámetros:

• table_name (requerido): Nombre de la tabla

• schema (opcional): Nombre del schema (por defecto: 'public')

Ejemplo de uso:

3. query

Ejecuta una consulta SELECT de solo lectura.

Parámetros:

• sql (requerido): Consulta SQL SELECT

• limit (opcional): Límite de filas a retornar (por defecto: 100)

Ejemplo de uso:

4. table_stats

Obtiene estadísticas de una tabla.

Parámetros:

• table_name (requerido): Nombre de la tabla

• schema (opcional): Nombre del schema (por defecto: 'public')

Ejemplo de uso:

Seguridad

🔒 Este servidor está diseñado para ser de solo lectura:

• Solo permite consultas SELECT

• Bloquea operaciones: INSERT, UPDATE, DELETE, DROP, CREATE, ALTER, TRUNCATE, etc.

• Aplica límites automáticos a las consultas que no especifican LIMIT

Desarrollo

Troubleshooting

Error de conexión a PostgreSQL

• Verifica que PostgreSQL esté corriendo

• Confirma las credenciales en el archivo .env

• Verifica que el usuario tenga permisos de lectura en la base de datos

El servidor no aparece en Claude Desktop

• Asegúrate de haber reiniciado Claude Desktop después de editar la configuración

• Verifica que la ruta al archivo build/index.js sea absoluta y correcta

• Revisa los logs de Claude Desktop para ver errores

"Query no permitida"

• Solo se permiten consultas SELECT

• Asegúrate de no usar operaciones de escritura en tus queries