PostgreSQL MCP

Servidor PostgreSQL MCP para conectar agentes de IA a bancos de dados Postgres, inspecionar esquemas e executar consultas SQL por meio de ferramentas MCP.

Documentação

Servidor MCP PostgreSQL

smithery badge

Um servidor Model Context Protocol (MCP) que fornece capacidades de execução de consultas diretamente em bancos de dados PostgreSQL. Este servidor permite a execução de consultas SQL personalizadas em bancos de dados PostgreSQL com suporte a consultas parametrizadas e timeouts configuráveis. Este projeto foi projetado especificamente para uso com o IDE Cursor.

Pré-requisitos

  • Node.js >= 18.0.0
  • Servidor PostgreSQL (para operações no banco de dados de destino)
  • Acesso de rede às instâncias PostgreSQL de destino

Instalação

Instalação via Smithery

Para instalar o Servidor de Consulta de Banco de Dados PostgreSQL para o Claude Desktop automaticamente via Smithery:

npx -y @smithery/cli install @1Levick3/postgresql-mcp-server --client claude

Instalação Manual

  1. Clone o repositório
  2. Instale as dependências:
    npm install
    
  3. Compile o servidor:
    npm run build
    
  4. Adicione ao arquivo de configurações do MCP:
     {
       "mcpServers": {
         "postgresql-mcp": {
           "command": "node",
           "args": ["/Users/1Levick3/Desktop/postgresql-mcp-server/build/index.js"],
           "disabled": false,
           "alwaysAllow": [],
           "env": {
             "POSTGRES_CONNECTION_STRING": "postgresUrl",
             "POSTGRES_SSL_CERT_PATH": "/Users/1levick3/Desktop/root.crt"
           }
         }
       }
     }
    

Desenvolvimento

  • npm run dev - Inicie o servidor de desenvolvimento com recarregamento automático
  • npm run lint - Execute o ESLint
  • npm test - Execute os testes

Considerações de Segurança

  1. Segurança da Conexão
    • Utiliza pool de conexões
    • Implementa timeouts de conexão
    • Valida strings de conexão
    • Suporta conexões SSL/TLS

Contribuição

  1. Faça um fork do repositório
  2. Crie um branch de funcionalidade
  3. Faça commit das suas alterações
  4. Envie para o branch
  5. Crie um Pull Request