Serveur MCP pgconsole
Commit 30 oct. 2026Permettez aux agents IA d'interroger et de modifier PostgreSQL via un endpoint MCP sécurisé, avec des permissions par agent et un journal d'audit.
Aussi connu sous pgplex/pgconsole
- Étoiles
- 162
- Outils
- —
- Téléchargements, 30 jours
- —
- Dernière version
- —
- Dernier commit
- 30 oct. 2026
- Licence
- Apache-2.0
Qu'est-ce que pgconsole MCP ?
pgconsole est un serveur MCP. Permettez aux agents IA d'interroger et de modifier PostgreSQL via un endpoint MCP sécurisé, avec des permissions par agent et un journal d'audit.
Résumé généré à partir du README du projet
À propos du MCP server pgconsole
pgconsole permet aux équipes d'ingénierie de gérer l'accès à PostgreSQL pour les agents IA via un endpoint gouverné. Il offre un moyen d'exposer des connexions de base de données à des clients externes tels que Claude, Cursor ou des bots de CI via le Model Context Protocol sans partager les identifiants de base de données bruts. Les utilisateurs peuvent configurer le système à l'aide d'un unique fichier TOML et l'exécuter via npm, npx ou Docker.
Les développeurs utilisent cet outil pour implémenter un contrôle d'accès granulaire où les agents héritent de permissions spécifiques comme la lecture, l'écriture ou le DDL via une couche IAM. Le serveur prend en charge deux types d'agents : les comptes de service purs et les agents délégués agissant au nom des utilisateurs. Il inclut un éditeur SQL intégré pour les humains et un assistant IA compatible avec les fournisseurs OpenAI, Anthropic ou Google pour effectuer des tâches telles que le text-to-SQL et l'optimisation de requêtes.
La sécurité est maintenue grâce à une politique de default-deny et un journal d'audit complet. Chaque requête et chaque connexion est enregistrée sous forme de JSON structuré vers stdout, permettant aux équipes de suivre les actions entreprises par les humains et les agents automatisés. Le système garantit que des outils comme list_objects ou query ne deviennent disponibles qu'une fois qu'un agent dispose d'une connexion autorisée.
Ce que vous pouvez faire avec
- 1Accorder l'accès à la base de données aux agents de manière sécuriséeFournissez à un agent IA des permissions spécifiques pour interroger une base de données sans exposer le mot de passe réel de la base de données.
- 2Auditer tous les changements de base de données pilotés par l'IASuivez chaque instruction SQL exécutée par un agent IA pour garantir la conformité et la visibilité.
- 3Convertir le langage naturel en SQLUtilisez l'assistant IA intégré pour transformer une description en anglais simple en une requête PostgreSQL fonctionnelle.
Extrait du README du projet. Chaque cas d'utilisation est vérifié par rapport à une citation du document.
Vérifications automatisées
Exécuté le 13 nov. 2026Rapport complet →Pas encore vérifié. Un serveur nécessite un score de 80, aucune faille sérieuse et suffisamment de données pour que nous puissions effectuer les vérifications. Fonctionnement des vérifications · Ce qu'il faut corriger pour gagner des points
- Dépôt source lié et accessiblepgplex/pgconsole is public and reachablegithub.com/pgplex/pgconsole ↗Réussi
- Le nom du package correspond au dépôt sourceNon vérifié
- Provenance du build (attestation Sigstore)Non vérifié
- Licence open source (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Réussi
- Commit ou version publiée au cours de l'année écouléeLast commit or release 2026-10-30github.com/pgplex/pgconsole ↗Réussi
- OpenSSF ScorecardNon vérifié
- Nom du package non proche d'un package populaireNon vérifié
- Aucun avis critique dans le package ou ses dépendancesNon vérifié
- Aucune instruction cachée destinée au modèle0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersRéussi
- Les outils destructifs sont étiquetésNon vérifié
- Le point de terminaison distant répond à la poignée de main MCPNon vérifié
README
Voir sur 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.
Questions sur pgconsole MCP
Comment un agent IA s'authentifie-t-il au MCP server pgconsole ?
Les agents se connectent à un endpoint streamable HTTP à l'adresse /mcp et s'authentifient avec un bearer token défini pour l'agent dans le fichier de configuration.
Quels outils un agent obtient-il sur le MCP server pgconsole ?
Chaque agent peut lister les connexions ; les outils de catalogue et d'exécution apparaissent en fonction des permissions accordées à cet agent.
Les agents ont-ils besoin d'identifiants de base de données bruts pour utiliser pgconsole ?
Non. Les agents utilisent l'endpoint MCP et héritent des mêmes contrôles IAM, de permissions et d'audit que les utilisateurs humains, au lieu d'utiliser des identifiants de base de données.
Les requêtes des agents sont-elles auditées dans pgconsole ?
Oui, chaque instruction passe par une détection des permissions SQL, un système IAM de type default-deny et le journal d'audit.
Quels types d'agents peuvent être configurés dans pgconsole ?
Vous pouvez configurer un compte de service pur autorisé par des règles IAM, ou un agent délégué qui agit au nom d'un utilisateur avec des permissions éventuellement réduites.