Simple MySQL MCP Server

Servidor MCP (Model Context Protocol) para MySQL com arquitetura limpa e princípios SOLID.

- Separação de Responsabilidades: Classes especializadas para cada função
- SOLID Principles: Código mais maintível e extensível
- Clean Architecture: Estrutura modular e testável

- Validação de Queries: Proteção contra operações perigosas
- Sanitização: Nomes de tabelas validados
- SQL Injection Protection: Parâmetros seguros

- Conexão Reutilizada: Gerenciamento eficiente de recursos
- Tratamento de Erros: Mensagens consistentes e informativas
- Shutdown Gracioso: Encerramento controlado de conexões

MySQLMCPServer ├── DatabaseConfig (Configurações) ├── DatabaseConnection (Conexão MySQL) ├── QueryValidator (Validação e Segurança) ├── ResponseFormatter (Formatação) ├── ToolsHandler (Ferramentas) ├── ResourcesHandler (Recursos) └── PromptsHandler (Templates)

- execute_query: Executa queries SQL com validação
- describe_table: Descreve estrutura de tabelas

- mysql://databases: Lista de bancos disponíveis
- mysql://tables: Tabelas do banco atual
- mysql://schema: Schema completo

- analyze_table: Análise detalhada de tabela
- find_large_tables: Tabelas com mais registros
- database_overview: Visão geral do banco

MYSQL_HOST=localhost MYSQL_PORT=3306 MYSQL_USER=root MYSQL_PASSWORD=sua_senha MYSQL_DATABASE=seu_banco

# Compilar npm run build # Executar npm start # Desenvolvimento npm run dev

Adicione aoclaude_desktop_config.json:

{ "mcpServers": { "mysql-optimized": { "command": "node", "args": ["/caminho/para/dist/index.js"], "env": { "MYSQL_HOST": "localhost", "MYSQL_PORT": "3306", "MYSQL_USER": "root", "MYSQL_PASSWORD": "sua_senha", "MYSQL_DATABASE": "seu_banco" } } } }

- ✅ Bloqueio deDROP DATABASE/TABLE
- ✅ Proteção contraDELETE ... WHERE 1=1
- ✅ Sanitização de nomes de tabelas
- ✅ Validação de queries vazias
- ✅ Tratamento seguro de parâmetros

- 🔒 Conexões controladas
- 🔒 Logs de erro seguros
- 🔒 Isolamento de responsabilidades
- 🔒 Validação de entrada

// Executar query segura { "name": "execute_query", "arguments": { "query": "SELECT * FROM usuarios LIMIT 5", "database": "meu_banco" } } // Analisar tabela { "name": "describe_table", "arguments": { "table_name": "usuarios" } }

- ✅ Conexão estabelecida
- 🔄 Queries executadas
- ❌ Erros com detalhes
- 🔚 Shutdown gracioso

- Cache de resultados
- Métricas de performance
- Pool de conexões
- Suporte a transações
- Interface web de monitoramento
- Fork o projeto
- Crie uma branch (git checkout -b feature/nova-funcionalidade)
- Commit suas mudanças (git commit -m 'Adiciona nova funcionalidade')
- Push para a branch (git push origin feature/nova-funcionalidade)
- Abra um Pull Request

- ✨ Arquitetura otimizada com SOLID
- 🔒 Validação e segurança aprimoradas
- 🚀 Performance melhorada
- 📚 Documentação expandida

- 🎉 Versão inicial
- 🔧 Implementação básica MCP
- 🗄️ Suporte MySQL completo

MIT License - veja o arquivoLICENSEpara detalhes.

Access and manage MariaDB or MySQL databases using an MCP server.