pgconsole MCP server
Commit 30. Okt. 2026Ermöglicht es AI-Agenten, PostgreSQL über einen kontrollierten MCP-Endpoint abzufragen und zu modifizieren – inklusive individueller Berechtigungen pro Agent und Audit-Logging.
Auch bekannt als pgplex/pgconsole
- Stars
- 162
- Tools
- —
- Downloads, 30 Tage
- —
- Neueste Version
- —
- Letzter Commit
- 30. Okt. 2026
- Lizenz
- Apache-2.0
Was ist pgconsole MCP?
pgconsole ist ein MCP server. Ermöglicht es AI-Agenten, PostgreSQL über einen kontrollierten MCP-Endpoint abzufragen und zu modifizieren – inklusive individueller Berechtigungen pro Agent und Audit-Logging.
Zusammenfassung generiert aus dem README des Projekts
Über pgconsole MCP server
pgconsole ermöglicht es Engineering-Teams, den PostgreSQL-Zugriff für AI-Agenten über einen kontrollierten Endpoint zu verwalten. Es bietet eine Möglichkeit, Datenbankverbindungen für externe Clients wie Claude, Cursor oder CI-Bots über das Model Context Protocol bereitzustellen, ohne die echten Datenbank-Credentials teilen zu müssen. Nutzer können das System über eine einzige TOML-Datei konfigurieren und via npm, npx oder Docker ausführen.
Entwickler nutzen dieses Tool, um eine feingranulare Zugriffskontrolle zu implementieren, bei der Agenten spezifische Berechtigungen wie Read, Write oder DDL über eine IAM-Schicht erben. Der Server unterstützt zwei Arten von Agenten: reine Service Accounts und delegierte Agenten, die im Namen von Nutzern handeln. Er enthält einen integrierten SQL-Editor für Menschen sowie einen AI-Assistenten, der mit OpenAI, Anthropic oder Google Providern zusammenarbeitet, um Aufgaben wie Text-to-SQL und Query-Optimierung zu übernehmen.
Die Sicherheit wird durch eine Default-Deny-Policy und ein umfassendes Audit-Logging gewährleistet. Jede Query und jeder Login wird als strukturiertes JSON an stdout protokolliert, sodass Teams die Aktionen von sowohl Menschen als auch automatisierten Agenten nachverfolgen können. Das System stellt sicher, dass Tools wie list_objects oder query erst dann verfügbar werden, wenn ein Agent eine autorisierte Verbindung aufgebaut hat.
Was du damit machen kannst
- 1Sicheren Datenbankzugriff für Agenten gewährenGib einem AI-Agenten spezifische Berechtigungen zum Abfragen einer Datenbank, ohne das eigentliche Datenbank-Passwort preiszugeben.
- 2KI-gesteuerte Datenbankänderungen auditierenVerfolge jedes von einem AI-Agenten ausgeführte SQL-Statement, um Compliance und Transparenz sicherzustellen.
- 3Natürliche Sprache in SQL umwandelnNutze den integrierten AI-Assistenten, um eine einfache englische Beschreibung in eine funktionale PostgreSQL-Query zu transformieren.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
Automatisierte Checks
Geluften am 13. Nov. 2026Vollständiger Bericht →Noch nicht verifiziert. Ein Server benötigt einen Score von 80, keine kritischen Befunde und genug Daten für unsere Prüfung. Wie die Checks funktionieren · Was du für mehr Punkte verbessern kannst
- Source Repository verknüpft und erreichbarpgplex/pgconsole is public and reachablegithub.com/pgplex/pgconsole ↗Bestanden
- Paket nennt dieses Repository als QuelleNicht geprüft
- Build-Provenienz (Sigstore-Attestierung)Nicht geprüft
- Open Source Lizenz (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Bestanden
- Commit oder Release im letzten JahrLast commit or release 2026-10-30github.com/pgplex/pgconsole ↗Bestanden
- OpenSSF ScorecardNicht geprüft
- Package-Name ähnelt keinem populären PackageNicht geprüft
- Keine kritischen Advisories im Paket oder seinen AbhängigkeitenNicht geprüft
- Keine versteckten Anweisungen an das Modell0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersBestanden
- Destruktive Tools sind markiertNicht geprüft
- Remote-Endpoint beantwortet den MCP-HandshakeNicht geprüft
README
Auf GitHub ansehen[!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.
pgconsole MCP Fragen
Wie authentifiziert sich ein AI-Agent beim pgconsole MCP server?
Agenten verbinden sich mit einem Streamable HTTP Endpoint unter /mcp und authentifizieren sich mit einem Bearer Token, der für den Agenten in der Config-Datei definiert ist.
Welche Tools stehen einem Agenten auf dem pgconsole MCP server zur Verfügung?
Jeder Agent kann Verbindungen auflisten; Catalog- und Execution-Tools werden basierend auf den dem Agenten zugewiesenen Berechtigungen bereitgestellt.
Benötigen Agenten rohe Datenbank-Credentials, um pgconsole zu nutzen?
Nein. Agenten nutzen den MCP Endpoint und übernehmen dieselben IAM-, Permission- und Audit-Kontrollen wie menschliche Nutzer, anstatt direkte Datenbank-Credentials zu verwenden.
Werden Agenten-Queries in pgconsole protokolliert?
Ja, jedes Statement durchläuft eine SQL-Permission-Detection, ein Default-Deny-IAM und das Audit-Log.
Welche Arten von Agenten können in pgconsole konfiguriert werden?
Du kannst entweder ein reines Service Account via IAM-Regeln autorisieren oder einen delegierten Agenten konfigurieren, der im Namen eines Nutzers mit optional eingeschränkten Berechtigungen agiert.