postgres/postgres-mcp

O que postgres-mcp faz?

Servidor MCP para PostgreSQL com introspecção de esquema, execução de consultas e suporte a migrações

Visão Geral

O postgres/postgres-mcp é um servidor MCP (Model Context Protocol) que permite que agentes de IA interajam com bancos de dados PostgreSQL. Ele fornece capacidades de introspecção de esquema, execução de consultas SQL e gerenciamento de migrações, tudo através de uma interface padronizada.

Funcionalidades

• Introspecção de Esquema: Descubra tabelas, colunas, índices e relacionamentos em seu banco de dados.
• Execução de Consultas: Execute consultas SQL de forma segura, com suporte a prepared statements.
• Suporte a Migrações: Aplique e reverta migrações de banco de dados programaticamente.

Configuração

Configure o servidor definindo as seguintes variáveis de ambiente:

export DATABASE_URL="postgresql://user:password@localhost:5432/mydb"
export PGPASSWORD="sua_senha_aqui"

Para usar com SSL/TLS:

export PGSSLMODE="require"
export PGSSLROOTCERT="/caminho/para/ca.pem"

Uso com Clientes MCP

Claude Code

Adicione ao seu arquivo claude_desktop_config.json:

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": ["-y", "@postgres/postgres-mcp"],
      "env": {
        "DATABASE_URL": "postgresql://user:password@localhost:5432/mydb"
      }
    }
  }
}

Cursor

Configure no arquivo .cursor/mcp.json:

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": ["-y", "@postgres/postgres-mcp"],
      "env": {
        "DATABASE_URL": "postgresql://user:password@localhost:5432/mydb"
      }
    }
  }
}

Comandos Disponíveis

Comando	Descrição
list_tables	Lista todas as tabelas no banco de dados atual
describe_table	Mostra esquema detalhado de uma tabela
execute_query	Executa uma consulta SQL e retorna resultados
run_migration	Aplica um arquivo de migração SQL

Segurança

• Conexões SSL/TLS são suportadas para comunicação segura com o banco de dados.
• O servidor respeita permissões de banco de dados e não contorna controles de acesso.
• Consultas SQL executadas através do servidor são limitadas pelo usuário configurado na string de conexão.

Suporte a Múltiplas Plataformas

Este servidor MCP funciona com:

• Claude Code
• Cursor
• Codex
• Qualquer cliente que suporte o protocolo MCP

Licença

Licenciado sob a Licença MIT.