MCP server pgconsole
Commit 30 de out. de 2026Permite que agentes de IA consultem e modifiquem o PostgreSQL por meio de um endpoint MCP governado, com permissões por agente e logs de auditoria.
Também conhecido como pgplex/pgconsole
- Stars
- 162
- Ferramentas
- —
- Downloads, 30 dias
- —
- Versão mais recente
- —
- Último commit
- 30 de out. de 2026
- Licença
- Apache-2.0
O que é o MCP pgconsole?
pgconsole é um MCP server. Permite que agentes de IA consultem e modifiquem o PostgreSQL por meio de um endpoint MCP governado, com permissões por agente e logs de auditoria.
Resumo gerado a partir do README do projeto
Sobre o MCP server de pgconsole
O pgconsole permite que equipes de engenharia gerenciem o acesso ao PostgreSQL para agentes de IA por meio de um endpoint governado. Ele oferece uma maneira de expor conexões de banco de dados para clientes externos como Claude, Cursor ou bots de CI via Model Context Protocol sem compartilhar credenciais brutas do banco de dados. Os usuários podem configurar o sistema usando um único arquivo TOML e executá-lo via npm, npx ou Docker.
Desenvolvedores utilizam esta ferramenta para implementar controle de acesso granular, onde os agentes herdam permissões específicas como leitura, escrita ou DDL por meio de uma camada de IAM. O servidor suporta dois tipos de agentes: contas de serviço puras e agentes delegados que atuam em nome de usuários. Ele inclui um editor SQL integrado para humanos e um assistente de IA que trabalha com provedores OpenAI, Anthropic ou Google para realizar tarefas como text-to-SQL e otimização de consultas.
A segurança é mantida por meio de uma política de negação padrão e logs de auditoria abrangentes. Cada consulta e login é registrado como JSON estruturado no stdout, permitindo que as equipes rastreiem as ações realizadas tanto por humanos quanto por agentes automatizados. O sistema garante que ferramentas como list_objects ou query só fiquem disponíveis quando um agente possuir uma conexão autorizada.
O que você pode fazer com ele
- 1Conceder acesso ao banco de dados para agentes de forma seguraForneça a um agente de IA permissões específicas para consultar um banco de dados sem expor a senha real do banco.
- 2Auditar todas as alterações no banco de dados impulsionadas por IARastreie cada instrução SQL executada por um agente de IA para garantir conformidade e visibilidade.
- 3Converter linguagem natural em SQLUse o assistente de IA integrado para transformar uma descrição em inglês simples em uma consulta PostgreSQL funcional.
Escrito a partir do README do projeto. Cada caso de uso é verificado com uma citação dele.
Verificações automatizadas
Executado em 13 de nov. de 2026Relatório completo →Ainda não verificado. Um servidor precisa de uma pontuação de 80, nenhum problema grave e dados suficientes para verificarmos. Como as verificações funcionam · O que corrigir para ganhar mais pontos
- Repositório de origem vinculado e acessívelpgplex/pgconsole is public and reachablegithub.com/pgplex/pgconsole ↗Passou
- O pacote indica este repositório como sua origemNão verificado
- Proveniência da build (atestação Sigstore)Não verificado
- Licença de código aberto (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Passou
- Commit ou release no último anoLast commit or release 2026-10-30github.com/pgplex/pgconsole ↗Passou
- OpenSSF ScorecardNão verificado
- Nome do pacote não é próximo a um pacote popularNão verificado
- Nenhum aviso crítico no pacote ou em suas dependênciasNão verificado
- Sem instruções ocultas para o modelo0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPassou
- Ferramentas destrutivas estão rotuladasNão verificado
- O endpoint remoto responde ao handshake do MCPNão verificado
README
Ver no 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.
Perguntas sobre o MCP pgconsole
Como um agente de IA se autentica no MCP server do pgconsole?
Os agentes se conectam a um endpoint de streamable HTTP em /mcp e se autenticam com um bearer token definido para o agente no arquivo de configuração.
Quais ferramentas um agente recebe no MCP server do pgconsole?
Cada agente pode listar conexões; as ferramentas de catálogo e execução aparecem com base nas permissões concedidas a esse agente.
Os agentes precisam de credenciais brutas do banco de dados para usar o pgconsole?
Não. Os agentes usam o endpoint MCP e herdam os mesmos controles de IAM, permissão e auditoria que usuários humanos, em vez de credenciais de banco de dados.
As consultas dos agentes são auditadas no pgconsole?
Sim, cada instrução passa pela detecção de permissão SQL, IAM de negação padrão (default-deny) e pelo log de auditoria.
Que tipos de agentes podem ser configurados no pgconsole?
Você pode configurar uma conta de serviço pura autorizada por regras de IAM ou um agente delegado que atua em nome de um usuário com permissões opcionalmente reduzidas.