pgconsole MCP sunucusu
Commit 30 Eki 2026Yapay zeka ajanlarının, her ajana özel izinler ve denetim günlükleri ile yönetilen bir MCP uç noktası üzerinden PostgreSQL sorgulamasına ve üzerinde değişiklik yapmasına olanak tanır.
Ayrıca bilinen adı pgplex/pgconsole
- Yıldızlar
- 162
- Araçlar
- —
- İndirmeler, 30 gün
- —
- En son sürüm
- —
- Son commit
- 30 Eki 2026
- Lisans
- Apache-2.0
pgconsole MCP nedir?
pgconsole bir MCP sunucusudur. Yapay zeka ajanlarının, her ajana özel izinler ve denetim günlükleri ile yönetilen bir MCP uç noktası üzerinden PostgreSQL sorgulamasına ve üzerinde değişiklik yapmasına olanak tanır.
Özet, projenin README dosyasından oluşturuldu
pgconsole MCP sunucusu hakkında
pgconsole, mühendislik ekiplerinin yapay zeka ajanları için PostgreSQL erişimini yönetilen bir uç nokta üzerinden yönetmesini sağlar. Veritabanı bağlantılarını, ham veritabanı kimlik bilgilerini paylaşmadan Model Context Protocol aracılığıyla Claude, Cursor veya CI botları gibi harici istemcilere açmanın bir yolunu sunar. Kullanıcılar sistemi tek bir TOML dosyası kullanarak yapılandırabilir ve npm, npx veya Docker üzerinden çalıştırabilir.
Geliştiriciler bu aracı, ajanların bir IAM katmanı aracılığıyla okuma, yazma veya ddl gibi belirli izinleri devraldığı hassas erişim kontrolü uygulamak için kullanırlar. Sunucu iki tür ajanı destekler: saf servis hesapları ve kullanıcılar adına hareket eden delege ajanlar. İnsanlar için entegre bir SQL editörü ve text-to-SQL ile sorgu optimizasyonu gibi görevleri yerine getirmek için OpenAI, Anthropic veya Google sağlayıcılarıyla çalışan bir yapay zeka asistanı içerir.
Güvenlik, varsayılan reddetme politikası ve kapsamlı denetim günlüğü ile sağlanır. Her sorgu ve oturum açma işlemi stdout'a yapılandırılmış JSON olarak kaydedilir; bu da ekiplerin hem insanlar hem de otomatik ajanlar tarafından gerçekleştirilen eylemleri takip etmesine olanak tanır. Sistem, list_objects veya query gibi araçların yalnızca bir ajan yetkili bir bağlantıya sahip olduğunda kullanılabilir olmasını sağlar.
Neler yapabilirsiniz
- 1Ajanlara güvenli veritabanı erişimi sağlamaGerçek veritabanı şifresini ifşa etmeden bir yapay zeka ajanına bir veritabanını sorgulaması için belirli izinler sağlayın.
- 2Yapay zeka destekli tüm veritabanı değişikliklerini denetlemeUyumluluk ve görünürlük sağlamak için bir yapay zeka ajanı tarafından yürütülen her SQL ifadesini takip edin.
- 3Doğal dili SQL'e dönüştürmeDüz bir İngilizce açıklamayı işlevsel bir PostgreSQL sorgusuna dönüştürmek için yerleşik yapay zeka asistanını kullanın.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
Otomatik kontroller
Çalıştırıldı 13 Kas 2026Tam rapor →Henüz doğrulanmadı. Bir sunucunun 80 puana, ciddi bir bulgu olmamasına ve kontrol edebilmemiz için yeterli veriye ihtiyacı vardır. Kontroller nasıl çalışır · Daha fazla puan için nelerin düzeltileceği
- Kaynak deposu bağlantılı ve erişilebilirpgplex/pgconsole is public and reachablegithub.com/pgplex/pgconsole ↗Geçti
- Paket, bu depoyu kaynağı olarak gösteriyorKontrol edilmedi
- Derleme kökeni (Sigstore onayı)Kontrol edilmedi
- Açık kaynak lisansı (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Geçti
- Son bir yıl içinde commit veya sürüm mevcutLast commit or release 2026-10-30github.com/pgplex/pgconsole ↗Geçti
- OpenSSF ScorecardKontrol edilmedi
- Paket adı popüler bir pakete yakın değilKontrol edilmedi
- Pakette veya bağımlılıklarında kritik uyarı yokKontrol edilmedi
- Modele yönelik gizli talimat yok0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersGeçti
- Yıkıcı araçlar etiketlenmişKontrol edilmedi
- Uzak uç nokta MCP el sıkışmasına yanıt veriyorKontrol edilmedi
[!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 soruları
Bir yapay zeka ajanı pgconsole MCP server'ına nasıl kimlik doğrular?
Ajanlar, /mcp adresindeki bir Streamable HTTP uç noktasına bağlanır ve yapılandırma dosyasında ajan için tanımlanan bir bearer token ile kimlik doğrular.
Bir ajan pgconsole MCP server üzerinde hangi araçlara sahip olur?
Her ajan bağlantıları listeleyebilir; katalog ve yürütme araçları, o ajana verilen izinlere bağlı olarak görünür.
Ajanların pgconsole kullanmak için ham veritabanı kimlik bilgilerine ihtiyacı var mı?
Hayır. Ajanlar veritabanı kimlik bilgileri yerine MCP uç noktasını kullanır ve insan kullanıcılarla aynı IAM, izin ve denetim kontrollerini devralır.
Ajan sorguları pgconsole içinde denetleniyor mu?
Evet, her ifade SQL izin algılama, varsayılan reddetme (default-deny) IAM ve denetim günlüğü üzerinden çalıştırılır.
pgconsole içinde ne tür ajanlar yapılandırılabilir?
IAM kuralları ile yetkilendirilmiş saf bir servis hesabı veya isteğe bağlı olarak azaltılmış izinlerle bir kullanıcı adına hareket eden delege bir ajan yapılandırabilirsiniz.