MCP Postgres + charts

Servidor MCP que conecta modelos de lenguaje con consultas PostgreSQL de solo lectura y generación de gráficos. El proyecto documenta controles de consulta, herramientas de exploración de esquema y monitoreo para convertir datos en respuestas y visualizaciones.

Acceso controlado a datos

• Usuario PostgreSQL de permisos mínimos y solo lectura.
• Validación SQL mediante SQLGlot para restringir operaciones de escritura y cambios de esquema.
• Timeouts, límites de filas y recursos y registro de eventos de seguridad.
• Herramientas list_available_tables, get_table_columns y query_database para explorar y consultar los datos.

Visualizaciones y monitoreo

generate_plot_from_query combina una consulta con configuración JSON. La documentación enumera 16 tipos de gráficos: líneas, barras, dispersión, histogramas, pastel, área, cajas, mapas de calor, violín, hexbin, escalones, stem, barras de error, barras apiladas, múltiples líneas y subplots.

Los gráficos se generan en modo headless y pueden codificarse en Base64. Los recursos MCP exponen esquema, estadísticas, ejemplos, métricas y alertas con umbrales configurables.

Arquitectura y documentación

Servidor en Python para PostgreSQL, con ejecución directa o Docker Compose. El repositorio contiene documentación de usuario, API, arquitectura, despliegue y pruebas. El alcance es consulta y visualización; la escritura sobre la base no forma parte del flujo diseñado.