Servidor MCP Postgres em Go

Eu publiquei um projeto que venho construindo como um projeto paralelo: um servidor MCP em Go que conecta o Claude Code (ou Cursor) diretamente a um banco de dados PostgreSQL ao vivo.

Repo: github.com/gupta-akshay/postgres-mcp

O problema que ele resolve

A maioria dos fluxos de trabalho de "IA mais banco de dados" ainda se parece com isso: copiar SQL de uma janela de chat, colar em um cliente de banco de dados, executá-lo, copiar a saída de volta. Isso quebra o fluxo, e o assistente nunca vê seu esquema real, então ele faz suposições.

O MCP resolve o problema de conexão. Este servidor é o que fica do outro lado para o Postgres.

O que ele faz

O servidor expõe nove ferramentas através do MCP:

• Introspecção de esquema - tabelas reais, colunas, índices, restrições
• execute_sql - executar consultas diretamente (somente leitura em modo restrito)
• explain_query - EXPLAIN ANALYZE, incluindo contra um índice hipotético
• get_top_queries - puxar consultas lentas de pg_stat_statements
• Conselheiros de índice - recomendar índices usando um Conselheiro de Ajuste de Banco de Dados ganancioso construído em hypopg
• analyze_db_health - vacuum, XID wraparound, atraso de replicação, índices inválidos e mais, verificados em paralelo

Isso significa que você pode perguntar "por que esta consulta é lenta" e o assistente realmente executa o EXPLAIN, verifica as estatísticas e pode simular um índice antes que alguém toque no esquema.

Por que Go

O projeto é inspirado no crystaldba/postgres-mcp em Python. Eu o reconstruí do zero em Go para que ele seja enviado como um único binário estático de ~15 MB. Sem tempo de execução Python, sem busca de dependências. docker build, aponte o Claude Code para ele, pronto.

O modo restrito envolve cada chamada em uma transação somente leitura, portanto, a proteção contra gravação vem do próprio Postgres, não da correspondência de strings no texto da consulta.

Onde olhar

O repositório tem as instruções completas de configuração, a configuração do Docker e a suíte de testes (unitários, integração e ponta a ponta contra um container Postgres real com pg_stat_statements e hypopg). A CI falha com menos de 95% de cobertura.

Se você passa tempo real no Claude Code ou Cursor e também se preocupa com o desempenho do Postgres, dê uma olhada: github.com/gupta-akshay/postgres-mcp

Eu escrevi sobre a construção em mais detalhes no meu blog e no dev.to se você quiser os detalhes da arquitetura e dos testes.