MCP server de pgconsole
Commit 30 oct 2026Permite que los agentes de IA consulten y modifiquen PostgreSQL a través de un endpoint MCP gobernado con permisos por agente y registro de auditoría.
También conocido como pgplex/pgconsole
- Stars
- 162
- Herramientas
- —
- Descargas, 30 días
- —
- Última versión
- —
- Último commit
- 30 oct 2026
- Licencia
- Apache-2.0
¿Qué es pgconsole MCP?
pgconsole es un MCP server. Permite que los agentes de IA consulten y modifiquen PostgreSQL a través de un endpoint MCP gobernado con permisos por agente y registro de auditoría.
Resumen generado a partir del README del proyecto
Acerca del MCP server de pgconsole
pgconsole permite a los equipos de ingeniería gestionar el acceso a PostgreSQL para agentes de IA mediante un endpoint gobernado. Proporciona una forma de exponer conexiones de bases de datos a clientes externos como Claude, Cursor o bots de CI a través del Model Context Protocol sin compartir las credenciales reales de la base de datos. Los usuarios pueden configurar el sistema usando un único archivo TOML y ejecutarlo mediante npm, npx o Docker.
Los desarrolladores utilizan esta herramienta para implementar un control de acceso granular donde los agentes heredan permisos específicos como lectura, escritura o ddl a través de una capa de IAM. El servidor admite dos tipos de agentes: cuentas de servicio puras y agentes delegados que actúan en nombre de los usuarios. Incluye un editor SQL integrado para humanos y un asistente de IA que funciona con proveedores de OpenAI, Anthropic o Google para realizar tareas como text-to-SQL y optimización de consultas.
La seguridad se mantiene mediante una política de denegación por defecto y un registro de auditoría exhaustivo. Cada consulta e inicio de sesión se registra como JSON estructurado en stdout, lo que permite a los equipos rastrear las acciones realizadas tanto por humanos como por agentes automatizados. El sistema garantiza que herramientas como list_objects o query solo estén disponibles una vez que un agente tenga una conexión autorizada.
Qué puedes hacer con él
- 1Otorgar acceso seguro a la base de datos para agentesProporciona a un agente de IA permisos específicos para consultar una base de datos sin exponer la contraseña real de la misma.
- 2Auditar todos los cambios en la base de datos impulsados por IARastrea cada sentencia SQL ejecutada por un agente de IA para garantizar el cumplimiento y la visibilidad.
- 3Convertir lenguaje natural a SQLUtiliza el asistente de IA integrado para transformar una descripción en lenguaje natural en una consulta de PostgreSQL funcional.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Verificaciones automáticas
Ejecutado 13 nov 2026Informe completo →Aún no verificado. Un servidor necesita una puntuación de 80, ningún hallazgo grave y suficientes datos para que podamos revisarlo. Cómo funcionan las verificaciones · Qué corregir para obtener más puntos
- Repositorio de origen vinculado y accesiblepgplex/pgconsole is public and reachablegithub.com/pgplex/pgconsole ↗Aprobado
- El paquete indica este repositorio como su origenNo verificado
- Procedencia de la compilación (atestación de Sigstore)No verificado
- Licencia de código abierto (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Aprobado
- Commit o lanzamiento en el último añoLast commit or release 2026-10-30github.com/pgplex/pgconsole ↗Aprobado
- OpenSSF ScorecardNo verificado
- El nombre del paquete no es similar a un paquete popularNo verificado
- No hay avisos críticos en el paquete ni en sus dependenciasNo verificado
- Sin instrucciones ocultas para el modelo0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersAprobado
- Las herramientas destructivas están etiquetadasNo verificado
- El endpoint remoto responde al handshake de MCPNo verificado
README
Ver en GitHub[!NOTE] pgplex: The Postgres Toolchain for Humans and Agents - pgconsole · pgschema · pgtui · pgparser
Brought to you by Bytebase, open-source database governance platform.

pgconsole is a web-based PostgreSQL editor. Single binary, single config file, no database required. Connect your team to PostgreSQL with access control and audit logging built in.
Installation
Visit https://docs.pgconsole.com/getting-started/quickstart
Prerequisites
- Node.js 20+
npm
npm install -g @pgplex/pgconsole
pgconsole --config pgconsole.toml
npx
npx @pgplex/pgconsole --config pgconsole.toml
Docker
docker run -p 9876:9876 -v /path/to/pgconsole.toml:/etc/pgconsole.toml pgplex/pgconsole
Run without --config to start in demo mode with a bundled sample database.
Features
SQL Editor
A full-featured SQL workspace for writing, running, editing, and inspecting PostgreSQL, with parser-powered intelligence in the editor.
- Autocomplete — context-aware suggestions for tables, columns, joins, and CTEs
- Formatting — pretty-print or collapse SQL to one line
- Error detection — red underlines with hover tooltips
- Code folding — collapse
SELECT,WITH, and other blocks - Function signature help — parameter hints as you type
- Result grid & inline editing — virtual-scrolling query results with staged edits, generated SQL previews, and optional AI risk assessment before execution
- Schema browser — inspect tables, views, materialized views, functions, and procedures with metadata, indexes, constraints, triggers, and grants
AI Assistant
Generate, explain, fix, and rewrite SQL with an AI assistant that understands your schema context. Supports OpenAI, Anthropic, and Google providers.
- Text-to-SQL — describe a query in natural language, get SQL back
- Explain SQL — get plain-language explanations of any query
- Fix SQL — AI-powered error correction from inline linting
- Rewrite SQL — optimize queries for performance or readability
- Risk assessment — analyze staged changes for potential risks before execution
MCP Server
Expose your Postgres connections to external AI agents (Claude, Cursor, IDEs, CI bots) over the Model Context Protocol — without handing out raw database credentials. Agents connect to a remote MCP endpoint and inherit the same IAM, permission, and audit controls as human users.
- Remote & token-authenticated — a Streamable HTTP endpoint at
/mcp; each agent authenticates withAuthorization: Bearer <token> - Two agent kinds — a pure service account (authorized by
agent:<id>IAM rules) or a delegated agent that acts on behalf of a user, optionally capped to fewer permissions or connections - Permission-shaped tools — every agent can
list_connections; catalog tools (list_objects,describe_table) appear once it has an accessible connection, and execution tools unlock per grant:explain_query(explain),query(read),write_data(write),run_ddl(ddl) - Same governance as the UI — every statement runs through per-statement SQL permission detection, default-deny IAM, and the audit log
# A standalone agent, authorized via [[iam]] just like a user
[[agents]]
id = "ci-bot"
name = "CI Pipeline"
token = "generate-a-long-random-secret" # openssl rand -hex 32
[[iam]]
connection = "staging"
permissions = ["read", "ddl"]
members = ["agent:ci-bot"]
Database Access Control
Fine-grained IAM controls who can read, write, or administer each connection. Permissions are enforced at the application layer — no database roles needed.
- Default deny — users have no access unless a rule explicitly grants it
- Connection-scoped — permissions are granted per connection, not globally
- Disjoint permissions —
read,write,ddl,admin,explain,execute,exportare independent
Audit Log
Every query and login is recorded as structured JSON to stdout. Filter and forward to your log infrastructure.
{
"type": "audit",
"ts": "2024-01-15T10:32:15.456Z",
"action": "sql.execute",
"actor": "alice@example.com",
"connection": "prod-db",
"sql": "SELECT * FROM users WHERE active = true",
"duration_ms": 45,
"row_count": 150
}
Single-File Configuration
Everything lives in pgconsole.toml — connections, users, groups, access rules, AI providers. No database required.
[[connections]]
id = "production"
name = "Production"
host = "db.example.com"
port = 5432
database = "myapp"
username = "readonly"
password = "..."
[[iam]]
connection = "production"
permissions = ["read", "explain", "export"]
members = ["*"]
[[iam]]
connection = "production"
permissions = ["*"]
members = ["group:dba"]
[[ai.providers]]
id = "claude"
vendor = "anthropic"
model = "claude-sonnet-4-20250514"
api_key = "sk-ant-..."
Getting Help
Development
[!NOTE] For external contributors: If you want to request a feature, please create a GitHub issue to discuss first instead of creating a PR directly.
git clone https://github.com/pgplex/pgconsole.git
cd pgconsole
pnpm install
pnpm dev # Start dev server (frontend + backend)
pnpm build # Production build
pnpm test # Run all tests
Sponsor
Bytebase - open source, web-based database DevSecOps platform.
Preguntas sobre pgconsole MCP
¿Cómo se autentica un agente de IA en el MCP server de pgconsole?
Los agentes se conectan a un endpoint de streamable HTTP en /mcp y se autentican con un bearer token definido para el agente en el archivo de configuración.
¿Qué herramientas recibe un agente en el MCP server de pgconsole?
Cada agente puede listar conexiones; las herramientas de catálogo y ejecución aparecen según los permisos otorgados a ese agente.
¿Necesitan los agentes credenciales directas de la base de datos para usar pgconsole?
No. Los agentes utilizan el endpoint MCP y heredan los mismos controles de IAM, permisos y auditoría que los usuarios humanos en lugar de usar credenciales de la base de datos.
¿Se auditan las consultas de los agentes en pgconsole?
Sí, cada sentencia pasa por la detección de permisos SQL, el IAM de denegación por defecto y el registro de auditoría.
¿Qué tipo de agentes se pueden configurar en pgconsole?
Puedes configurar una cuenta de servicio pura autorizada por reglas de IAM, o un agente delegado que actúe en nombre de un usuario con permisos opcionalmente reducidos.