IA by DNACX

#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.

  1. 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.

  2. 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"
          ]
        }
      }
    }
  3. 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.

  4. 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
  5. 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

← #9 n8n-mcp · #11 Figma Context →

Ver os 15 MCPs

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.