Postgres para Agentes IA

Qué incluye este pack

Este pack reúne las cinco superficies SQL que un agente realmente necesita para leer, escribir y razonar sobre una base de datos Postgres. Dos son servidores MCP stdio que apuntas a tu DSN. Uno es un MCP universal que maneja Postgres, MySQL, SQLite y más. Los dos últimos son proveedores Postgres gestionados con integración de agente de primer nivel.

El servidor PostgreSQL MCP de referencia vive en el repo oficial modelcontextprotocol/servers y es el binding stdio más simple: query, list_tables, describe_table. La variante comunitaria añade explain, index_advice y escrituras parametrizadas. DBHub abstrae la capa de conexión para que una instalación MCP llegue a Postgres, MySQL, SQLite o DuckDB. Neon y Supabase publican sus propios MCPs que van más allá de SQL puro — Neon expone la creación de branches como herramienta (una DB por tarea de agente), Supabase expone auth, storage y Row Level Security.

Por qué Postgres para agentes importa

La mayoría de demos "agente + base de datos" hacen trampa. Usan SQLite efímero, fixtures hechos a mano, sin concurrencia. Las apps reales corren en Postgres con cientos de tablas, políticas RLS, columnas JSON y connection pooling existente. Conectar un LLM a esa superficie ingenuamente es como acabas con un DELETE sin WHERE en producción.

Este pack escoge los cinco servidores que manejan las realidades:

• Modo solo lectura por defecto. Los cinco vienen con flags read-only o scoping de capacidades.
• Introspección de schema. El agente puede preguntar describe_table en vez de adivinar columnas.
• Connection pooling. Cada servidor reusa un pool — sin tormentas de reconexión por query.
• Branch / sandbox. La herramienta de branch de Neon da a cada tarea de agente su propia DB desechable en 200ms.

Instala en un comando

# Instalación pack — escribe configs MCP al config file de tu herramienta
tokrepo install pack/postgres-for-agents

# O elige servidores individuales
tokrepo install postgres-mcp
tokrepo install dbhub
tokrepo install neon-mcp
tokrepo install supabase-mcp

El TokRepo CLI escribe el config en el lugar correcto para cada herramienta — claude_desktop_config.json para Claude Code, mcp.json para Cursor, AGENTS.md para Codex CLI. Las connection strings viven en tus env vars; los configs solo llevan nombres de servidor.

Trampas comunes

• No expongas acceso de escritura el día 1. Empieza con --read-only. Promueve a read-write solo después de ver al agente ejecutar cientos de lecturas seguras.
• Usa un rol dedicado, no el superusuario postgres. Crea un rol mcp_agent con SELECT solo en los schemas que de verdad quieras exponer. Las políticas RLS deben aplicar también a ese rol.
• Vigila el coste del schema dump. list_tables en un schema de producción de 500 tablas puede reventar el contexto del agente. Filtra a un solo schema o lista permitida.
• Branching solo te da seguridad si lo usas. Los branches de Neon son baratos — crea uno por tarea, apunta el MCP al DSN del branch, y descarta después.
• El RLS de Supabase no es opcional. Si el agente conecta con la service role key, el RLS se bypasea. Usa anon + JWT para cualquier tarea con datos de usuario.

Relación con otros packs

Este pack es la capa de datos estructurados. Para recuperación semántica / no estructurada (búsqueda por similitud, RAG sobre documentos) quieres el pack Comparativa Vector DB — Chroma, Qdrant, Weaviate, Pinecone. Para el toolbox MCP más amplio (filesystem, browser, GitHub) ver Stack de Servidores MCP. Los agentes en producción típicamente usan uno de cada pack: Postgres para estado transaccional, vector DB para embeddings, MCP stack para superficies de herramienta.