Guia Para Iniciantes do Google MCP Toolbox para Bancos de Dados

Uma Introdução à MCP Toolbox

A MCP Toolbox é uma ferramenta gratuita do Google que ajuda suas aplicações de IA a se comunicarem com seus bancos de dados. Pense nela como um tradutor especial. Sua IA pode pedir informações de forma simples, e a MCP Toolbox traduz essa solicitação para a linguagem que seu banco de dados entende, como SQL. Ela usa algo chamado Model Context Protocol (MCP), que é apenas um conjunto padrão de regras para esse tipo de comunicação.

💡

Quer uma ótima ferramenta de Teste de API que gera documentação de API bonita?

Quer uma plataforma integrada, All-in-One, para sua Equipe de Desenvolvedores trabalhar com produtividade máxima?

Apidog entrega todas as suas demandas e substitui o Postman por um preço muito mais acessível!

botão

Por Que Você Deve Usar a MCP Toolbox

A MCP Toolbox não é apenas um tradutor; ela também torna a construção de suas aplicações de IA muito mais fácil e melhor.

A MCP Toolbox Simplifica Seu Código

Sem a MCP Toolbox, você teria que escrever muito código apenas para conectar sua IA ao seu banco de dados. Você precisaria de código para conexão, para tratamento de erros e para segurança. Com a MCP Toolbox, você apenas define suas ações de banco de dados em um arquivo de texto simples chamado tools.yaml. Este arquivo informa à toolbox quais ações são possíveis, e a toolbox cuida de todo o trabalho pesado de conectar-se ao banco de dados de forma segura.

A MCP Toolbox Melhora a Velocidade e a Segurança

A MCP Toolbox foi projetada para ser rápida. Ela usa uma técnica chamada "connection pooling", o que significa que ela mantém as conexões de banco de dados abertas e as reutiliza. Isso economiza muito tempo em comparação com a abertura de uma nova conexão para cada solicitação. Também é segura porque você gerencia todo o acesso ao banco de dados em um local central, reduzindo o risco de erros.

A MCP Toolbox Mostra o Que Está Acontecendo

Quando você tem uma IA, uma toolbox e um banco de dados trabalhando juntos, pode ser difícil ver o que está acontecendo. A MCP Toolbox possui suporte integrado para "observabilidade", o que significa que ela pode criar logs e rastreamentos de cada ação. Isso ajuda você a entender o que suas ferramentas estão fazendo, encontrar quaisquer problemas e ver como tornar as coisas mais rápidas.

Como a MCP Toolbox se Encaixa no Seu Projeto

A MCP Toolbox fica no meio da sua aplicação. O fluxo é o seguinte:

Sua Aplicação de IA: É aqui que seu modelo de IA reside. Ele decide que precisa de algumas informações do banco de dados para responder a uma pergunta.
A MCP Toolbox: A aplicação de IA envia uma solicitação para a MCP Toolbox. A toolbox consulta seu arquivo tools.yaml, encontra a ferramenta certa para a tarefa e executa o comando correspondente em seu banco de dados.
Seu Banco de Dados: O banco de dados executa o comando e envia os dados de volta para a MCP Toolbox, que então os passa para sua IA.

Essa configuração significa que sua aplicação principal de IA não precisa conhecer os detalhes complexos de como seu banco de dados funciona. Você pode até mesmo mudar suas ferramentas ou banco de dados sem ter que reescrever o código da sua aplicação de IA.

Um Guia Passo a Passo para Usar a MCP Toolbox

Vamos ver como fazer a MCP Toolbox funcionar em seu computador.

Passo 1: Prepare Seu Banco de Dados para a MCP Toolbox

Primeiro, você precisa de um banco de dados. Estes passos usam o PostgreSQL como exemplo. Você criará um usuário especial e um banco de dados para a toolbox usar.

Conecte-se ao seu servidor PostgreSQL.

Execute estes comandos SQL para criar um usuário chamado toolbox_user e um banco de dados chamado toolbox_db:

CREATE USER toolbox_user WITH PASSWORD 'my-password';
CREATE DATABASE toolbox_db;
GRANT ALL PRIVILEGES ON DATABASE toolbox_db TO toolbox_user;

Crie uma tabela de exemplo, como uma tabela hotels, para que suas ferramentas tenham alguns dados para trabalhar.

Passo 2: Instale e Configure a MCP Toolbox

Em seguida, você configurará a própria toolbox.

Baixe o programa MCP Toolbox da sua página oficial de lançamento no GitHub. Certifique-se de obter a versão correta para o seu computador (como Windows, Mac ou Linux).

Crie um novo arquivo chamado tools.yaml. Este arquivo é onde você definirá todas as ações que sua IA pode realizar. Aqui está um exemplo simples:

sources:
  my-pg-source:
    kind: postgres
    host: 127.0.0.1
    port: 5432
    database: toolbox_db
    user: toolbox_user
    password: my-password

tools:
  search-hotels-by-location:
    kind: postgres-sql
    source: my-pg-source
    description: Finds hotels in a specific city.
    parameters:
      - name: location
        type: string
        description: The city to search for hotels in.
    statement: SELECT * FROM hotels WHERE location = $1;

Passo 3: Execute o Servidor da MCP Toolbox

Agora você pode iniciar a toolbox. Abra seu terminal, vá para a pasta onde você baixou a toolbox e execute este comando:

./toolbox --tools-file "tools.yaml"

O servidor será iniciado e carregará as ferramentas que você definiu.

Como Testar com o Inspetor da MCP Toolbox

A MCP Toolbox vem com uma ferramenta de teste chamada Inspetor. Esta é uma página web que permite que você experimente suas ferramentas sem ter que escrever nenhum código.

Execute o Inspetor a partir do seu terminal com este comando: npx @modelcontextprotocol/inspector.
Abra o endereço web que ele fornece no seu navegador.
Instrua-o a conectar-se ao seu servidor MCP Toolbox em execução (geralmente em http://127.0.0.1:5000/mcp/sse).
Uma vez conectado, você pode ver uma lista de suas ferramentas, preencher seus parâmetros e executá-las para ver se funcionam corretamente.

Como Conectar Sua Aplicação à MCP Toolbox

Após o teste, você pode conectar sua aplicação de IA real. A MCP Toolbox possui SDKs (kits de desenvolvimento de software) para facilitar isso. Aqui está um exemplo simples em Python:

Instale o SDK Python: pip install toolbox-core.

Use este código para conectar-se à toolbox e carregar suas ferramentas:

from toolbox_core import ToolboxClient
import asyncio

async def main():
    async with ToolboxClient("http://127.0.0.1:5000") as client:
        tools = await client.load_toolset()
        # A variável 'tools' agora contém suas ferramentas de banco de dados
        # e você pode passá-las para seu modelo de IA.
        print("Ferramentas carregadas com sucesso!")

asyncio.run(main())

Este código conecta-se ao servidor da toolbox e baixa as ferramentas que você definiu. Você pode então passar essas ferramentas para seu agente de IA, e ele será capaz de usá-las para interagir com seu banco de dados.

Considerações Finais sobre a MCP Toolbox

A MCP Toolbox do Google é uma ferramenta fantástica para qualquer desenvolvedor que trabalha com IA e bancos de dados. Ela simplifica seu código, torna sua aplicação mais rápida e segura, e oferece a visibilidade necessária para entender como tudo está funcionando. Seguindo os passos deste guia, você pode começar a usar a MCP Toolbox para construir aplicações de IA mais poderosas e orientadas a dados.

💡

botão