Servidor MCP Postgres MCP

Consultar um PostgreSQL, analisar planos de execução e sugerir índices.

ComunidadeLocal · uvxmantido por Crystal DBA

O que é

Servidor da Crystal DBA para PostgreSQL. Além de executar SQL, avalia a saúde do banco e recomenda índices. Tem dois modos de acesso; a configuração gerada aqui usa o restrito, que o README descreve como somente leitura e adequado a produção. O servidor Postgres de referência do protocolo foi arquivado, e este é um dos substitutos mantidos.

Exemplos de pedidos

“Quais são as dez consultas mais lentas?”
“Que índice ajudaria esta consulta?”

Antes de instalar

Requer uv (uvx).

Sinais de confiança

Quem mantém: Comunidade Crystal DBAMantido por terceiros. O dono do serviço não responde por este código: leia o repositório antes de instalar.
Repositório: crystaldba/postgres-mcp
Licença: MIT
Último commit: 17/08/2026 (51 dias antes da coleta)
Estrelas: 3,4 mil
Registro oficial: Entrada não conferida por nós no registro oficial
Transporte: Local (stdio), iniciado com uvx
O que você preenche: DATABASE_URI — URI de conexão do PostgreSQLcredencial
Configuração conferida: 03/10/2026, no README do repositório

Estrelas, licença e último commit: API do GitHub, retrato incluído nesta versão do site, coletado em 07/10/2026. Situação no registro: registry.modelcontextprotocol.io, na mesma data.

Configurar o Postgres MCP em cada cliente

Sem token nesta página. O que está destacado você preenche na sua máquina. Para combinar com outros servidores ou gerar a versão para Windows, use o gerador com o Postgres MCP já marcado.

claude_desktop_config.json~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "postgres": {
      "command": "uvx",
      "args": [
        "postgres-mcp",
        "--access-mode=restricted"
      ],
      "env": {
        "DATABASE_URI": "<DATABASE_URI>"
      }
    }
  }
}

DATABASE_URI: Substitua <DATABASE_URI> pelo valor, direto no arquivo, na sua máquina. É uma credencial: não versione nem compartilhe o arquivo depois de preenchido.

Onde fica o arquivo e como conferir no Claude Desktop

ComandosTerminal, na pasta do projeto

claude mcp add --transport stdio --env "DATABASE_URI=<DATABASE_URI>" postgres -- uvx postgres-mcp --access-mode=restricted

DATABASE_URI: Substitua <DATABASE_URI> pelo valor, direto no comando, na sua máquina. É uma credencial: não versione nem compartilhe o arquivo depois de preenchido.

Onde fica o arquivo e como conferir no Claude Code

mcp.json.cursor/mcp.json

{
  "mcpServers": {
    "postgres": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "postgres-mcp",
        "--access-mode=restricted"
      ],
      "env": {
        "DATABASE_URI": "${env:DATABASE_URI}"
      }
    }
  }
}

DATABASE_URI: Defina a variável de ambiente DATABASE_URI no sistema. O arquivo guarda só a referência ${env:DATABASE_URI}.

Onde fica o arquivo e como conferir no Cursor

mcp.json.vscode/mcp.json

{
  "inputs": [
    {
      "type": "promptString",
      "id": "database-uri",
      "description": "URI de conexão do PostgreSQL",
      "password": true
    }
  ],
  "servers": {
    "postgres": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "postgres-mcp",
        "--access-mode=restricted"
      ],
      "env": {
        "DATABASE_URI": "${input:database-uri}"
      }
    }
  }
}

DATABASE_URI: O VS Code pede este valor em uma caixa de senha na primeira vez que o servidor inicia.

Onde fica o arquivo e como conferir no VS Code

mcp_config.json~/.config/devin/mcp_config.json

{
  "mcpServers": {
    "postgres": {
      "command": "uvx",
      "args": [
        "postgres-mcp",
        "--access-mode=restricted"
      ],
      "env": {
        "DATABASE_URI": "${env:DATABASE_URI}"
      }
    }
  }
}

DATABASE_URI: Defina a variável de ambiente DATABASE_URI no sistema. O arquivo guarda só a referência ${env:DATABASE_URI}.

Onde fica o arquivo e como conferir no Windsurf

O que ele alcança

Tudo o que o usuário da URI enxerga no banco.

Riscos e como reduzir

No modo unrestricted (o dos exemplos do README) o assistente altera dados e esquema. Só use em desenvolvimento.
A URI contém senha: mantenha-a fora de arquivos versionados.
Não é mantido pelo projeto PostgreSQL.

Contexto geral em Segurança no MCP. Código-fonte: github.com/crystaldba/postgres-mcp.

Outros servidores de bancos de dados

Perguntas frequentes

O servidor Postgres MCP é oficial?

Comunidade: é mantido por Crystal DBA, no repositório crystaldba/postgres-mcp. Mantido por terceiros. O dono do serviço não responde por este código: leia o repositório antes de instalar.

Que credenciais o Postgres MCP pede?

DATABASE_URI (uri de conexão do postgresql). O gerador deste site não recebe esse valor: ele entra na sua máquina, no lugar do marcador.

Como o Postgres MCP é executado?

É um servidor local, iniciado com uvx (exige uv). O cliente inicia o processo sozinho quando abre.

O Postgres MCP funciona no Cursor, no VS Code e no Claude Code?

Sim. Esta página traz o bloco de configuração para Claude Desktop, Claude Code, Cursor, VS Code e Windsurf, cada um no formato do cliente.

Quando esta configuração foi conferida?

Em 03/10/2026, no README do repositório crystaldba/postgres-mcp. Se o comando mudar depois disso, vale o que o repositório publicar.