#10 no GitHub · Dados e automação
Como instalar e usar o MCP Toolbox for Databases
Um servidor MCP de código aberto que conecta a IA a bancos de dados. Com ele a IA pode listar tabelas, explorar o esquema e executar SQL no banco que você configurar.
- Para quem
- Quem tem um banco de dados (PostgreSQL, MySQL, BigQuery e outros) e quer consultá-lo em linguagem natural pelo Claude Code.
- Estrelas (07/11/2026)
- 16.821, #10 no ranking
- Licença
- Apache 2.0
- Repositório
- googleapis/mcp-toolbox
Passo a passo
Antes de começar: Node.js (o README diz que o comando npx exige Node.js); Um banco de dados da lista de suportados, como PostgreSQL; Os dados de conexão do banco, informados por variáveis de ambiente (a lista por banco está na página Prebuilt Tools Reference do README); Um cliente compatível com MCP; o README cita Claude Code entre eles.
Escolha o banco
O servidor tem ferramentas prontas para cada banco, ativadas por uma opção --prebuilt. O exemplo do README usa PostgreSQL. A lista de bancos suportados está no README e inclui BigQuery, MySQL, SQL Server, MongoDB, Redis e outros.
Coloque a configuração no seu cliente
O README mostra um bloco JSON para o arquivo de configuração de MCP do cliente. O README não traz um comando 'claude mcp add' para este servidor; ele manda editar o arquivo de configuração do cliente (usualmente mcp.json ou claude_desktop_config.json).
Comando{ "mcpServers": { "toolbox-postgres": { "command": "npx", "args": [ "-y", "@toolbox-sdk/server", "--prebuilt=postgres", "--stdio" ] } } }Informe os dados de conexão do banco
Defina as variáveis de ambiente que o banco escolhido pede. Os nomes de cada variável estão na referência indicada pelo README.
Se quiser menos ferramentas, escolha um conjunto
Dá para carregar só um grupo de ferramentas. O exemplo do README carrega apenas as ferramentas de SQL do PostgreSQL.
Comando--prebuilt=postgres/data
Reinicie o cliente e converse com o banco
Depois de salvar a configuração, reinicie o cliente. O README fala em consultar os dados em inglês simples, explorar o esquema e gerar código com base no banco.
Primeiro teste
O README não traz um pedido de teste. Peça uma tarefa simples e confira se o servidor entra em ação.
Cuidados
- O servidor dá à IA acesso direto ao banco que você configurar, e entre as ferramentas prontas o README cita execute_sql. Pense antes de apontar para um banco de produção.
- O README descreve o uso por npx como otimizado para conveniência e não para desempenho, e recomenda o binário ou a imagem de contêiner para uma instalação mais padrão e confiável.
- A senha do banco aparece no exemplo de arquivo tools.yaml do modo de ferramentas personalizadas. Guarde dados de conexão com cuidado.
- O servidor emite traces e métricas por OpenTelemetry; o README indica a opção --telemetry-otlp para definir o destino.
Como desfazer
O README não traz um passo de remoção. Quando o servidor é usado por npx, basta tirar a entrada 'toolbox-postgres' do arquivo de configuração do cliente. Essa última orientação é da DNACX e não está no README.
O que o README não confirma
Esta página foi montada lendo o README. Estes pontos não estão escritos lá:
- Se existe um comando 'claude mcp add' equivalente para este servidor (o README não traz).
- Quais variáveis de ambiente cada banco exige: estão na página Prebuilt Tools Reference, que não faz parte do README.
- Se a ferramenta consegue apenas ler ou também alterar dados em cada banco.
- Custos de qualquer banco ou serviço em nuvem usado.
Dúvidas
Quais bancos funcionam?
O README lista bancos do Google Cloud (como AlloyDB, BigQuery, Cloud SQL, Spanner e Firestore) e outros, como PostgreSQL, MySQL, SQL Server, Oracle, MongoDB, Redis, Snowflake e mais.
Posso criar minhas próprias ferramentas?
Sim. O README descreve um modo de ferramentas personalizadas, configurado em um arquivo tools.yaml com fontes, ferramentas e conjuntos de ferramentas.
Existe versão gerenciada pelo Google?
O README cita os servidores MCP gerenciados do Google Cloud como alternativa para quem quer uma solução gerenciada.
O que mudou de nome?
O README informa que o repositório genai-toolbox foi renomeado para mcp-toolbox.
A DNACX usa o MCP Toolbox for Databases?
Esta página foi montada a partir do README oficial. A DNACX não rodou cada passo, então confira a saída de cada comando e, se algo falhar, volte ao README do repositório.
Próximo da lista
Por Diogo Kammers, da DNACX. Passo a passo montado a partir do README oficial de googleapis/mcp-toolbox, lido em . A DNACX não rodou cada passo desta página. O servidor é de terceiros e a DNACX não o criou.