Converse com seu Banco de Dados MySQL com Claude — Sem SQL Necessário
Se você usa o Claude diariamente, já sabe que ele é ótimo para escrever, codificar e responder perguntas. Mas e se o Claude também pudesse consultar seu banco de dados MySQL ao vivo — em inglês simples?
É exatamente isso que o plugin MySQL MCP Server torna possível. Neste tutorial, vou mostrar como instalá-lo e começar a ter conversas reais com seu banco de dados em menos de cinco minutos.
O que é MCP?
MCP (Model Context Protocol) é um padrão aberto que permite que assistentes de IA como o Claude se conectem a ferramentas externas e fontes de dados. Pense nisso como um sistema de plugins: em vez de copiar e colar dados na janela de chat do Claude, você conecta o Claude diretamente à fonte.
Com um servidor MCP em funcionamento, o Claude pode ler e escrever dados em tempo real — sem exportações manuais, sem malabarismos em SQL.
O que você pode fazer com este plugin?
Uma vez conectado, você pode perguntar ao Claude coisas como:
- "Quais tabelas estão no meu banco de dados?"
- "Mostre-me todos os pedidos feitos nos últimos 7 dias."
- "Quantos usuários se inscreveram este mês em comparação com o mês passado?"
- "Atualize o status do pedido #1042 para 'enviado'."
Claude traduz seu pedido em inglês simples na consulta SQL correta, executa-a e lhe dá uma resposta legível por humanos. Você permanece na conversa — sem mudar para um cliente SQL.
Pré-requisitos
- Node.js 18+ instalado em sua máquina
- Uma instância MySQL em funcionamento (local ou remota)
- Claude Desktop ou Claude Code (CLI)
Passo 1: Baixe o Plugin
Acesse a página de lançamentos e baixe o arquivo mais recente .mcpb:
mysql-mcp-server-v1.0.1.mcpb
.mcpb é o formato de pacote de plugin do Claude — um único arquivo que contém tudo o que é necessário para executar o servidor.
Passo 2: Instale o Plugin
Opção A — Claude Code (CLI):
claude plugin install mysql-mcp-server-v1.0.1.mcpb
Opção B — Claude Desktop:
Clique duas vezes no arquivo .mcpb. O Claude Desktop irá detectá-lo e abrir um prompt de instalação.
Passo 3: Configure sua Conexão com o Banco de Dados
Após a instalação, o Claude pedirá seus detalhes de conexão. Preencha os campos:
| Campo | Exemplo | Notas |
|---|---|---|
| Host do Banco de Dados | 127.0.0.1 |
Use o IP do seu servidor para bancos de dados remotos |
| Porta do Banco de Dados | 3306 |
Porta padrão do MySQL |
| Usuário do Banco de Dados | root |
Use um usuário com privilégios mínimos em produção |
| Senha do Banco de Dados | •••••• |
Armazenada com segurança |
| Nome do Banco de Dados | mydb |
O banco de dados específico para se conectar |
| Limite de Conexão | 10 |
Máximo de conexões simultâneas |
Dica: Para uso em produção, crie um usuário MySQL dedicado somente para leitura para o Claude. Isso evita gravações acidentais se você só precisar consultar dados.
Você pode atualizar essas configurações a qualquer momento nas configurações do plugin do Claude sob MySQL MCP Server.
Passo 4: Experimente
Uma vez conectado, inicie uma nova conversa no Claude e experimente estes comandos:
Explore seu esquema:
"Quais tabelas eu tenho? Dê-me um resumo rápido do que cada uma armazena."
Consulta dados em inglês simples:
"Mostre-me os 10 registros mais recentes com seus e-mails e datas de criação."
Obtenha agregações sem escrever SQL:
"Quantos pedidos estão em cada status? Mostre-me uma divisão."
Escreva dados quando precisar:
"Defina o
is_activecomo falso para todos os usuários que não fizeram login desde janeiro."
O Claude mostrará a consulta SQL que está prestes a executar antes de realizar operações de gravação, para que você esteja sempre no controle.
Ferramentas Disponíveis
O plugin expõe cinco ferramentas que o Claude usa nos bastidores:
| Ferramenta | O que faz |
|---|---|
select_mysql_version |
Retorna a versão do servidor MySQL |
list_tables |
Lista todas as tabelas no banco de dados conectado |
describe_table |
Mostra colunas, tipos e restrições de uma tabela |
query |
Executa uma consulta SELECT somente leitura |
mutate |
Executa instruções INSERT, UPDATE ou DELETE |
mutate rejeita instruções SELECT — leituras e gravações são intencionalmente separadas.
Quer Construir em Cima Disso?
O código-fonte está no GitHub: iamdylanngo/mysql-mcp-server
Foi construído com TypeScript, o MCP SDK, mysql2, e Zod para validação de entrada. PRs e problemas são bem-vindos.
Conclusão
O MySQL MCP Server fecha a lacuna entre a compreensão de linguagem do Claude e seus dados reais. Se você já quis fazer perguntas sobre seu banco de dados da mesma forma que perguntaria a um colega, este é o plugin para experimentar.
Baixe-o na página de lançamentos e me avise o que você construiu com ele nos comentários.
Tags: claude mcp mysql ai database
O uso do MySQL MCP Server pode transformar a maneira como empresas brasileiras interagem com seus dados, permitindo consultas em linguagem natural. Isso pode aumentar a eficiência e reduzir a necessidade de conhecimento técnico em SQL, democratizando o acesso à informação.
