MySQL

Servidor MCP para MySQL

Patrocinador — Bloome

Usando mcp-server-mysql para deixar sua IA consultar MySQL? Bloome leva isso para toda a sua equipe — uma plataforma de mensagens com agentes de IA onde agentes de IA são membros do chat. Conecte suas ferramentas MCP e tenha agentes inspecionando esquemas, executando consultas e respondendo perguntas sobre dados para todos em um único tópico. Zero configuração local, roda na nuvem, na web e no celular.

---

Servidor MCP que dá ao Claude e outros LLMs acesso ao MySQL — inspecione esquemas, execute consultas e, opcionalmente, grave dados, tudo através do Model Context Protocol.

Principais Recursos

• Somente leitura por padrão — operações de escrita ativadas por flags de ambiente
• Integração com Claude Code — otimizado para o CLI Claude Code da Anthropic
• Suporte a túnel SSH — suporte integrado para bancos de dados remotos
• Modo multi-banco — consulte vários bancos de dados sem reconectar
• Permissões específicas por esquema — controle de leitura/escrita por banco
• Redação de PII — mascaramento automático de dados sensíveis nos resultados
• Modo remoto — transporte HTTP com autenticação por token bearer
• Suporte SSL/TLS — conexões criptografadas com opção mTLS

Requisitos

• Node.js v20+
• MySQL 5.7+ (8.0+ recomendado)
• Usuário MySQL com privilégios adequados

Instalação Rápida

Claude Code (mais simples):

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

Claude Desktop / outros clientes:

{
  "mcpServers": {
    "mcp_server_mysql": {
      "command": "npx",
      "args": ["-y", "@benborla29/mcp-server-mysql"],
      "env": {
        "MYSQL_HOST": "127.0.0.1",
        "MYSQL_PORT": "3306",
        "MYSQL_USER": "root",
        "MYSQL_PASS": "your_password",
        "MYSQL_DB": "your_database"
      }
    }
  }
}

Todas as operações de escrita estão desabilitadas por padrão. Ative com ALLOW_INSERT_OPERATION=true, ALLOW_UPDATE_OPERATION=true, ALLOW_DELETE_OPERATION=true.

Documentação

• Guia de Instalação — Smithery, Cursor, Codex, Claude Code, repositório local, modo remoto
• Configuração e Variáveis de Ambiente — todas as variáveis de ambiente, configuração avançada
• Modo Multi-Banco — consultando vários bancos de dados
• Redação de PII — mascaramento automático de dados
• Testes — configuração e execução de testes
• Solução de Problemas — problemas comuns e correções
• Changelog

Ferramentas e Recursos

Ferramenta: mysql_query Execute consultas SQL. Somente leitura por padrão. Operações de escrita habilitadas por flag.

Recursos: mysql://tables Lista todas as tabelas e metadados de colunas do banco de dados conectado.

Contribuindo

PRs são bem-vindos em github.com/benborla/mcp-server-mysql.

git clone https://github.com/benborla/mcp-server-mysql.git
pnpm install
pnpm run build
pnpm test

Licença

MIT — veja LICENSE para detalhes.