Repolode
benborla

benborla/mcp-server-mysql

Servidor MCP que oferece a LLMs como Claude acesso somente de leitura a bancos MySQL, com operações de escrita opcionais habilitadas por flags.

Estrelas
2,175
Forks
260
Issues abertas
51
Último commit
há 3 meses

O que é?

Este projeto implementa o Model Context Protocol (MCP) para MySQL, permitindo que um cliente LLM, como Claude Code ou Claude Desktop, inspecione schemas de bancos de dados e execute consultas SQL em um servidor MySQL. Ele foi projetado para que o modelo explore os dados sem alterá-los: o modo somente leitura é o padrão, e as operações de inserção, atualização e exclusão precisam ser habilitadas individualmente por meio de variáveis de ambiente.

Além das consultas básicas, o projeto oferece várias proteções e conveniências. Ele aceita túneis SSH para acessar bancos de dados remotos, um modo multi-database para consultar vários bancos sem reconectar e permissões de leitura e escrita por banco de dados. A redação automática de PII oculta valores sensíveis nos resultados, e há suporte a conexões SSL/TLS com configuração opcional de mTLS. Um modo remoto disponibiliza o servidor por HTTP com autenticação por bearer token.

O servidor é instalado via npx e configurado com variáveis de ambiente MYSQL_*. Requer Node.js 20 ou posterior e MySQL 5.7 ou mais recente; a versão 8.0 é recomendada.

Recursos principais

  • 01Somente leitura por padrão, com inserção, atualização e exclusão habilitadas por flags separadas.
  • 02Inspeção de schemas e execução de consultas SQL disponibilizadas como ferramentas e recursos MCP.
  • 03Suporte a túneis SSH para bancos de dados remotos.
  • 04Modo multi-database para consultar vários bancos sem reconectar.
  • 05Redação automática de PII para ocultar valores sensíveis nos resultados das consultas.
  • 06Conexões SSL/TLS com mTLS opcional, além de modo remoto por HTTP com autenticação por bearer token.

Casos de uso

  • Permitir que Claude Code ou Claude Desktop explore um schema MySQL e responda a perguntas sobre os dados.
  • Oferecer a um assistente de IA acesso analítico seguro e somente de leitura a dados semelhantes aos de produção.
  • Consultar uma instância MySQL remota por meio de um túnel SSH, usando um cliente de IA local.
  • Fazer análises entre bancos de dados em uma única sessão de LLM.

Início rápido

  1. 1

    Requer Node.js v20 ou superior e um usuário do MySQL com os privilégios adequados

  2. 2

    Registre o servidor no Claude Code e configure as variáveis de ambiente de conexão com o MySQL

    claude mcp add mcp_server_mysql -e MYSQL_HOST="127.0.0.1" -e MYSQL_PORT="3306" -e MYSQL_USER="root" -e MYSQL_PASS="your_password" -e MYSQL_DB="your_database" -- npx @benborla29/mcp-server-mysql

Antes de usar

  • Requer Node.js v20 ou superior e um banco de dados MySQL 5.7 ou superior (recomenda-se 8.0 ou superior).
  • As operações de gravação ficam desativadas por padrão e precisam ser ativadas com flags de ambiente separadas.

Em coleções

Tópicos

Perguntas frequentes

O que é mcp-server-mysql?
Servidor MCP que oferece a LLMs como Claude acesso somente de leitura a bancos MySQL, com operações de escrita opcionais habilitadas por flags. Este projeto implementa o Model Context Protocol (MCP) para MySQL, permitindo que um cliente LLM, como Claude Code ou Claude Desktop, inspecione schemas de bancos de dados e execute consultas SQL em um servidor MySQL. Ele foi projetado para que o modelo explore os dados sem alterá-los: o modo somente leitura é o padrão, e as operações de inserção, atualização e exclusão precisam ser habilitadas individualmente por meio de variáveis de ambiente.
mcp-server-mysql é gratuito? Qual é a licença?
mcp-server-mysql é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
mcp-server-mysql ainda é mantido?
Atualizado nos últimos 6 meses. O último commit de mcp-server-mysql foi em 27 de jul. de 2026.
Para que posso usar mcp-server-mysql?
Permitir que Claude Code ou Claude Desktop explore um schema MySQL e responda a perguntas sobre os dados. Oferecer a um assistente de IA acesso analítico seguro e somente de leitura a dados semelhantes aos de produção. Consultar uma instância MySQL remota por meio de um túnel SSH, usando um cliente de IA local. Fazer análises entre bancos de dados em uma única sessão de LLM.
Como instalar mcp-server-mysql?
Requer Node.js v20 ou superior e um usuário do MySQL com os privilégios adequados Registre o servidor no Claude Code e configure as variáveis de ambiente de conexão com o MySQL: claude mcp add mcp_server_mysql -e MYSQL_HOST="127.0.0.1" -e MYSQL_PORT="3306" -e MYSQL_USER="root" -e MYSQL_PASS="your_password" -e MYSQL_DB="your_database" -- npx @benborla29/mcp-server-mysql
Onde consigo mcp-server-mysql?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/benborla/mcp-server-mysql

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados