O MCP Toolbox for Databases é uma plataforma de gerenciamento de ferramentas de banco de dados de código aberto projetada para ajudar os desenvolvedores a criar e gerenciar ferramentas de banco de dados com mais facilidade, rapidez e segurança. Ela atua como um plano de controle entre aplicativos e bancos de dados, simplificando o desenvolvimento, a distribuição e a invocação de ferramentas. A plataforma é compatível com várias estruturas de desenvolvimento, como LangChain, LlamaIndex e GoogleGenAI, para implantação local ou na nuvem. Os usuários podem otimizar a eficiência das operações do banco de dados por meio de uma configuração simples e de uma pequena quantidade de código para obter a integração da ferramenta. O MCP Toolbox oferece pooling de conexões, autenticação e outros recursos para garantir o desempenho e a segurança. Ele é adequado para cenários que exigem o desenvolvimento rápido de ferramentas de banco de dados, como acesso a dados para agentes de IA ou gerenciamento automatizado de banco de dados. A versão atual é a 0.9.0 e ainda está na versão beta, com a possibilidade de atualizações importantes no futuro.
Lista de funções
- Gerenciamento centralizado de ferramentas: fornece uma plataforma unificada para armazenar e atualizar ferramentas, oferecendo suporte ao compartilhamento entre aplicativos e agentes.
- Carregamento dinâmico de ferramentas: oferece suporte ao carregamento dinâmico de ferramentas para atualizar a configuração da ferramenta sem reiniciar o aplicativo.
- Otimização da conexão com o banco de dados: pooling de conexões e mecanismos de autenticação incorporados para melhorar o desempenho e a segurança.
- Suporte a várias estruturas: compatível com LangChain, LlamaIndex, GoogleGenAI e outras estruturas de desenvolvimento.
- Consulta em linguagem natural: permite a consulta direta a bancos de dados por meio de linguagem natural sem a necessidade de escrever SQL complexo.
- Gerenciamento automatizado de banco de dados: suporte para geração automática de consultas, criação de tabelas e adição de índices.
- Geração de código com reconhecimento de contexto: geração de código de aplicativo e casos de teste com base no esquema do banco de dados.
- Implementação em várias plataformas: há suporte para Linux, Windows, macOS e implementações em contêineres (por exemplo, Docker).
Usando a Ajuda
Processo de instalação
O MCP Toolbox oferece vários métodos de instalação para diferentes ambientes de desenvolvimento. Veja a seguir as etapas detalhadas de instalação:
1. instalação binária
Os usuários podem baixar diretamente o arquivo binário para seu sistema operacional:
- Visite a página oficial de lançamento e selecione a versão correspondente (atualmente
0.9.0
). - Dependendo do sistema operacional e da arquitetura da CPU (por exemplo
linux/amd64
talvezdarwin/arm64
) Faça o download do arquivo binário:export OS="linux/amd64" curl -O https://storage.googleapis.com/genai-toolbox/v0.9.0/$OS/toolbox chmod +x toolbox
- comandante-em-chefe (militar)
toolbox
Mova o arquivo para um caminho do sistema (por exemplo/usr/local/bin
) para ser executado.
2. instalação em contêineres
A instalação com o Docker é mais adequada para ambientes de produção:
- Extraia a imagem oficial do Docker:
export VERSION=0.9.0 docker pull us-central1-docker.pkg.dev/database-toolbox/toolbox/toolbox:$VERSION
- Execute o contêiner, certificando-se de que a porta (padrão
5000
) Disponível:docker run -p 5000:5000 us-central1-docker.pkg.dev/database-toolbox/toolbox/toolbox:$VERSION
3. instalação do código-fonte
Requer o ambiente de linguagem Go (recomenda-se a versão mais recente):
- Execute o seguinte comando para instalar:
go install github.com/googleapis/genai-toolbox@v0.9.0
- Quando a configuração estiver concluída, execute
toolbox
Inicie o servidor.
4. configurar o arquivo tools.yaml
Após a instalação, você precisa configurar tools.yaml
para definir fontes de dados e ferramentas:
- estabelecer
tools.yaml
a configuração de exemplo é a seguinte:sources: my-pg-source: kind: postgres host: 127.0.0.1 port: 5432 database: toolbox_db user: ${USER_NAME} password: ${PASSWORD} tools: search-hotels-by-name: kind: postgres-sql source: my-pg-source description: Search for hotels based on name. parameters: - name: name type: string description: The name of the hotel.
- Use variáveis de ambiente (por exemplo
${USER_NAME}
) Armazene informações confidenciais e evite códigos rígidos. - Depois de salvar o arquivo, execute o seguinte comando para iniciar o servidor:
./toolbox
- A sobrecarga dinâmica é ativada por padrão e pode ser desativada com a adição do parâmetro
--disable-reload
Logotipo.
Funções principais
1. ferramentas de carregamento
A MCP Toolbox suporta o carregamento de ferramentas por meio de SDKs para uma variedade de estruturas. Aqui está um exemplo do SDK do Python:
- Instale o SDK (selecionado de acordo com a estrutura):
pip install toolbox-langchain
- Conjunto de ferramentas de carregamento:
from toolbox_langchain import ToolboxClient async with ToolboxClient("http://127.0.0.1:5000") as client: tools = await client.load_toolset("toolset_name")
- As ferramentas carregadas podem ser passadas diretamente para o aplicativo ou para o agente de IA.
2. consultas em linguagem natural
Os usuários podem consultar o banco de dados em linguagem natural. Por exemplo, a consulta "Pedidos entregues em 2024 e as mercadorias que eles contêm":
- Depois de configurar a fonte de dados, a ferramenta converte automaticamente a linguagem natural em consultas SQL.
- Em um IDE compatível, digite algo como "Find hotels in Basel with Basel in its name" (Encontrar hotéis na Basileia com Basileia no nome), e a ferramenta chamará
search-hotels-by-name
que retorna os resultados.
3. gerenciamento automatizado de banco de dados
O MCP Toolbox pode gerar automaticamente operações de banco de dados. Por exemplo:
- Criar tabela: descreva o requisito, como "Criar uma tabela de dados para armazenar informações do usuário", e a ferramenta gerará o SQL correspondente.
- Add Index (Adicionar índice): digite "Add Index to User Table" (Adicionar índice à tabela do usuário) e a ferramenta será executada automaticamente.
- O usuário simplesmente insere os requisitos no IDE e a ferramenta lida com as operações complexas.
4. geração de código com reconhecimento de contexto
A ferramenta gera código com base no esquema do banco de dados. Exemplo:
- Digite "Generate User Management Module Code" (Gerar código do módulo de gerenciamento de usuários) e a ferramenta gerará o código de operação CRUD com base na estrutura da tabela.
- Suporte à geração de casos de teste para garantir a confiabilidade do código.
Parar o servidor
Os servidores em execução podem ser acessados por meio do Ctrl+C
Encerrar. Para executar em segundo plano, use o Docker ou a ferramenta System Service Manager.
advertência
- A versão atual é beta (
0.9.0
), pode haver instabilidade; recomenda-se prestar atenção à página oficial de lançamento. - Certifique-se de ter uma conexão estável com a Internet, pois a extração de imagens do Docker pode exigir uma conexão científica com a Internet.
- Informações confidenciais (por exemplo, senhas de bancos de dados) devem ser gerenciadas usando variáveis de ambiente para evitar a divulgação.
cenário do aplicativo
- Desenvolvimento de agentes de IA
Os desenvolvedores usam o MCP Toolbox para criar rapidamente ferramentas de banco de dados para agentes de IA. Por exemplo, um bot de reserva de hotel pode consultar informações sobre o hotel por meio de linguagem natural e automatizar as operações de reserva, reduzindo os esforços de codificação manual. - Automação do gerenciamento de banco de dados
Os analistas de dados não precisam escrever SQL complexo; por meio da descrição em linguagem natural dos requisitos (como "estatísticas sobre vendas em 2024"), é possível obter os resultados da consulta, adequados para a rápida exploração de dados. - Compartilhamento de ferramentas entre equipes
As equipes de desenvolvimento podem armazenar ferramentas na MCP Toolbox e compartilhá-las com vários projetos ou agentes de IA, permitindo a reutilização de ferramentas e reduzindo os custos de manutenção. - Geração de código em tempo real
Desenvolvedores iniciantes ou ocupados podem aproveitar o recurso de reconhecimento de contexto para gerar rapidamente códigos de aplicativos relacionados a bancos de dados e reduzir os ciclos de desenvolvimento.
QA
- Quais bancos de dados são compatíveis com o MCP Toolbox?
Atualmente, o PostgreSQL é o principal suporte, e outros bancos de dados estão sendo desenvolvidos. Os usuários devem adicionar a opçãotools.yaml
Configure a fonte de dados correspondente no - Como você garante a segurança da ferramenta?
A plataforma oferece um mecanismo de autenticação integrado e suporta variáveis de ambiente para gerenciar informações confidenciais e evitar a codificação. Recomenda-se HTTPS para a implementação do servidor. - Ele exige um ambiente altamente configurável para ser executado?
Não, o MCP Toolbox foi projetado para ser leve e executado em máquinas de desenvolvimento comuns ou servidores em nuvem, e a implantação do Docker reduz ainda mais os requisitos ambientais. - Como faço para atualizar a ferramenta sem reiniciar o aplicativo?
O recarregamento dinâmico é ativado por padrão. Novas ferramentas ou atualizações de configuração entram em vigor automaticamente sem reiniciar o servidor.