postgresql mcp

Visão Geral

PostgreSQL MCP (comumente referido como Postgres MCP Pro) é um servidor Model Context Protocol (MCP) de código aberto projetado para dar aos agentes de IA acesso seguro e inteligente a bancos de dados PostgreSQL.

Ele vai muito além da execução básica de consultas, oferecendo modos configuráveis de somente leitura ou leitura/escrita, diagnósticos de desempenho abrangentes, recomendações automatizadas de índices e recursos de segurança de nível de produção. Construído para apoiar todo o ciclo de vida de desenvolvimento — desde a exploração do esquema e codificação até testes, implantação e manutenção contínua.

Implementações populares incluem a referência original da Anthropic (agora obsoleta/arquivada devido a considerações de segurança), forks da comunidade e versões aprimoradas como o Postgres MCP Pro da Crystal DBA.

Funcionalidades

• Modos de Acesso Configuráveis: Transações estritamente somente leitura (evita modificações) ou leitura/escrita controlada com segurança transacional.
• Exploração de Esquema & Dados: Listar tabelas, inspecionar esquemas, colunas, índices, restrições e executar consultas com suporte a linguagem natural.
• Análise de Desempenho: Verificações de saúde para cache de buffer, status de vacuum, atraso de replicação, utilização de conexões, limites de sequência e muito mais.
• Ajuste de Índices & Planos de Execução (Explain): Motor avançado de recomendação de índices que testa milhares de combinações; suporte a índices hipotéticos e planos de execução detalhados de consultas.
• Execução Segura de SQL: Wrappers somente leitura, validação de consultas e proteções contra operações perigosas.
• Otimizado para Agentes de IA: Ferramentas projetadas para baixo uso de tokens, formatação clara de saída e integração perfeita com Claude, Cursor, Gemini e outros clientes MCP.
• Docker & Implantação Fácil: Imagem Docker oficial para execuções consistentes e livres de dependências.
• Extensível: Suporta PostgreSQL da comunidade, RDS, Aurora e a maioria das instâncias PostgreSQL v12+.

Casos de Uso

• Desenvolvimento de Banco de Dados Assistido por IA: Permita que seu agente de IA explore esquemas, sugira consultas ótimas ou gere migrações em linguagem natural.
• Ajuste de Desempenho: Pergunte "Analise consultas lentas" ou "Recomende índices para esta tabela" — receba insights acionáveis com planos de execução.
• Monitoramento de Produção: Execute verificações de saúde, detecte inchaço (bloat) ou monitore vacuum/autovacuum sem SQL manual.
• Análise Segura de Dados: Conceda acesso somente leitura para relatórios, análises ou agentes de suporte ao cliente sem arriscar a integridade dos dados.
• Fluxo de Trabalho Completo de Desenvolvimento: Desde a configuração inicial do projeto e testes até implantação e otimização contínua — tudo impulsionado por IA conversacional.

Instalação & Início Rápido

Usando Docker (Recomendado)

Baixe e execute a imagem oficial:

docker run -p 8080:8080 crystaldba/postgres-mcp --connection-string "postgresql://user:pass@localhost:5432/mydb"

Instalação via Python / uv

uv pip install postgres-mcp
uv run postgres-mcp "postgresql://user:password@localhost:5432/dbname"

Configuração para Clientes (Claude Desktop, Cursor, etc.)

Adicione ao seu arquivo de configuração MCP (por exemplo, ~/.cursor/mcp.json ou às configurações do Claude) com o comando/argumentos apropriados apontando para o servidor em execução.

A documentação completa, exemplos de conexão e as melhores práticas de segurança estão disponíveis no repositório.

Notas de Segurança

• Prefira o modo somente leitura para agentes não confiáveis.
• A implementação de referência original da Anthropic tinha uma vulnerabilidade conhecida de injeção de SQL (corrigida nos forks e versões posteriores).
• Sempre use strings de conexão com usuários de privilégios mínimos e considere restrições em nível de rede.

Links

• GitHub (Postgres MCP Pro): crystaldba/postgres-mcp
• Outras implementações notáveis: pgEdge Postgres MCP, AWS Labs Aurora MCP, diversos forks da comunidade.
• Model Context Protocol: Especificação oficial do MCP.

O Postgres MCP transforma seu banco de dados em uma ferramenta de primeira classe para agentes de IA, tornando a interação inteligente com dados tão simples quanto conversar com seu assistente.