pgconsole MCP server
Commit 30 Okt 2026Memungkinkan AI agent untuk melakukan query dan modifikasi PostgreSQL melalui endpoint MCP yang terkelola dengan izin per-agent dan audit logging.
Juga dikenal sebagai pgplex/pgconsole
- Stars
- 162
- Tools
- —
- Unduhan, 30 hari
- —
- Versi terbaru
- —
- Commit terakhir
- 30 Okt 2026
- Lisensi
- Apache-2.0
Apa itu pgconsole MCP?
pgconsole adalah MCP server. Memungkinkan AI agent untuk melakukan query dan modifikasi PostgreSQL melalui endpoint MCP yang terkelola dengan izin per-agent dan audit logging.
Ringkasan dibuat dari README proyek
Tentang pgconsole MCP server
pgconsole memungkinkan tim engineering untuk mengelola akses PostgreSQL bagi AI agent melalui endpoint yang terkelola. Tool ini menyediakan cara untuk mengekspos koneksi database ke client eksternal seperti Claude, Cursor, atau CI bots melalui Model Context Protocol tanpa harus membagikan kredensial database mentah. Anda dapat mengonfigurasi sistem ini menggunakan satu file TOML dan menjalankannya via npm, npx, atau Docker.
Developer menggunakan tool ini untuk mengimplementasikan fine-grained access control di mana agent mewarisi permission spesifik seperti read, write, atau ddl melalui layer IAM. Server ini mendukung dua tipe agent: service account murni dan delegated agent yang bertindak atas nama pengguna. Sistem ini juga menyertakan SQL editor terintegrasi untuk manusia dan AI assistant yang bekerja dengan provider OpenAI, Anthropic, atau Google untuk melakukan tugas seperti text-to-SQL dan optimasi query.
Keamanan dijaga melalui kebijakan default-deny dan audit logging yang komprehensif. Setiap query dan login dicatat sebagai JSON terstruktur ke stdout, memungkinkan tim untuk melacak tindakan yang dilakukan baik oleh manusia maupun agent otomatis. Sistem memastikan bahwa tool seperti list_objects atau query hanya akan tersedia setelah agent memiliki koneksi yang terotorisasi.
Apa yang bisa Anda lakukan dengannya
- 1Memberikan akses database ke agent secara amanBerikan AI agent permission spesifik untuk melakukan query ke database tanpa mengekspos password database yang sebenarnya.
- 2Audit semua perubahan database yang didorong oleh AILacak setiap SQL statement yang dieksekusi oleh AI agent untuk memastikan kepatuhan dan visibilitas.
- 3Konversi bahasa alami ke SQLGunakan AI assistant bawaan untuk mengubah deskripsi bahasa Inggris biasa menjadi query PostgreSQL yang fungsional.
Ditulis berdasarkan README proyek. Setiap use case diperiksa terhadap kutipan dari README tersebut.
Pengecekan otomatis
Berjalan 13 Nov 2026Laporan lengkap →Belum diverifikasi. Sebuah server memerlukan skor 80, tidak ada temuan serius, dan data yang cukup untuk kami periksa. Cara kerja checks · Yang perlu diperbaiki untuk menambah poin
- Source repository terhubung dan dapat dijangkaupgplex/pgconsole is public and reachablegithub.com/pgplex/pgconsole ↗Lolos
- Nama paket mencantumkan repositori ini sebagai sumbernyaTidak diperiksa
- Provenance build (atestasi Sigstore)Tidak diperiksa
- Lisensi open source (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Lolos
- Ada commit atau release dalam satu tahun terakhirLast commit or release 2026-10-30github.com/pgplex/pgconsole ↗Lolos
- OpenSSF ScorecardTidak diperiksa
- Nama package tidak mirip dengan package populerTidak diperiksa
- Tidak ada advisory kritis pada paket atau dependensinyaTidak diperiksa
- Tidak ada instruksi tersembunyi untuk model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersLolos
- Tools yang bersifat destruktif telah diberi labelTidak diperiksa
- Endpoint remote merespons handshake MCPTidak diperiksa
README
Lihat di 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.
Pertanyaan tentang pgconsole MCP
Bagaimana cara AI agent melakukan autentikasi ke pgconsole MCP server?
Agent terhubung ke endpoint Streamable HTTP di /mcp dan melakukan autentikasi menggunakan bearer token yang telah ditentukan untuk agent tersebut di dalam file config.
Tool apa saja yang didapatkan agent pada pgconsole MCP server?
Setiap agent dapat melakukan list connections; tool untuk catalog dan execution akan muncul berdasarkan izin yang diberikan kepada agent tersebut.
Apakah agent membutuhkan kredensial database mentah untuk menggunakan pgconsole?
Tidak. Agent menggunakan endpoint MCP dan mewarisi kontrol IAM, permission, dan audit yang sama seperti pengguna manusia, alih-alih menggunakan kredensial database secara langsung.
Apakah query dari agent diaudit di pgconsole?
Ya, setiap statement dijalankan melalui deteksi permission SQL, default-deny IAM, dan audit log.
Jenis agent apa saja yang bisa dikonfigurasi di pgconsole?
Anda dapat mengonfigurasi service account murni yang diotorisasi oleh aturan IAM, atau delegated agent yang bertindak atas nama pengguna dengan opsi permission yang dikurangi.