# postgresql mcp

Postgres MCP Pro é um poderoso servidor de Protocolo de Contexto de Modelo (MCP) para PostgreSQL, que fornece acesso configurável de leitura/escrita, análise de desempenho avançada, ajuste de índices, planos de execução e execução segura de SQL para agentes de IA.

Canonical URL: https://a2a-mcp.org/entry/postgresql-mcp-pt

Language: pt

Category: MCP Servers

Updated: 2026-04-06

## 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:
```bash
docker run -p 8080:8080 crystaldba/postgres-mcp --connection-string "postgresql://user:pass@localhost:5432/mydb"
```

### Instalação via Python / uv
```bash
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](https://github.com/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.

## Tags

- mcp
- postgresql
- postgres
- servidor-mcp
- sql
- banco-de-dados
- agente-ia
- ajuste-de-índices
- análise-de-desempenho
- claude
- cursor

## Sources

- [Project website](https://github.com/crystaldba/postgres-mcp)