Servidor MCP enxuto e econômico em tokens que permite a clientes de IA consultar e explorar bancos de dados PostgreSQL, MySQL, SQL Server, Oracle, MariaDB e SQLite.
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
Requer Node.js v20 ou superior e um usuário do MySQL com os privilégios adequados
- 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
IDE nativa de banco de dados para macOS, Windows e Linux, compatível com PostgreSQL, MySQL, SQLite, Redis, MongoDB, SQL Server e ClickHouse, com servidor MCP integrado e chat com IA.
Cliente de banco de dados com IA e servidor MCP para desktop e web, compatível com Postgres, MySQL, MariaDB, SQL Server, ClickHouse e SQLite.
Cliente de banco de dados gratuito e local-first, com IA e workspace SQL, compatível com mais de 40 bancos via desktop, web, Docker e CLI.
Framework TypeScript para criar servidores MCP, MCP Apps com visualizações em React e clientes, com Inspector e CLI integrados.
Um servidor proxy MCP que reúne vários servidores MCP em um único endpoint HTTP para clientes como o Claude.