Provides tools to interact with a MySQL database, allowing users to execute SQL queries, inspect table structures, list databases and tables, and perform schema analysis.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MySQL MCP Server (Optimized)show me the schema for the users table"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Servidor MCP MySQL Otimizado
Servidor MCP (Model Context Protocol) para MySQL com arquitetura limpa e princípios SOLID.
🆕 Melhorias na v1.1.0
✨ Arquitetura Otimizada
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
🔒 Segurança Aprimorada
Validação de Queries: Proteção contra operações perigosas
Sanitização: Nomes de tabelas validados
SQL Injection Protection: Parâmetros seguros
🚀 Performance e Confiabilidade
Conexão Reutilizada: Gerenciamento eficiente de recursos
Tratamento de Erros: Mensagens consistentes e informativas
Shutdown Gracioso: Encerramento controlado de conexões
🏗️ Arquitetura
🎯 Conceitos MCP Implementados
1. Tools (Ferramentas)
execute_query: Executa queries SQL com validaçãodescribe_table: Descreve estrutura de tabelas
2. Resources (Recursos)
mysql://databases: Lista de bancos disponíveismysql://tables: Tabelas do banco atualmysql://schema: Schema completo
3. Prompts (Templates)
analyze_table: Análise detalhada de tabelafind_large_tables: Tabelas com mais registrosdatabase_overview: Visão geral do banco
🚀 Instalação e Uso
1. Instalar Dependências
2. Configurar MySQL
Crie um arquivo .env:
3. Compilar e Executar
4. Testar Conexão
🔧 Configuração Claude Desktop
Adicione ao claude_desktop_config.json:
🛡️ Segurança
Validações Implementadas:
✅ Bloqueio de
DROP DATABASE/TABLE✅ Proteção contra
DELETE ... WHERE 1=1✅ Sanitização de nomes de tabelas
✅ Validação de queries vazias
✅ Tratamento seguro de parâmetros
Práticas de Segurança:
🔒 Conexões controladas
🔒 Logs de erro seguros
🔒 Isolamento de responsabilidades
🔒 Validação de entrada
📊 Exemplo de Uso
🔍 Debug e Logs
O servidor fornece logs informativos:
✅ Conexão estabelecida
🔄 Queries executadas
❌ Erros com detalhes
🔚 Shutdown gracioso
📈 Roadmap
Cache de resultados
Métricas de performance
Pool de conexões
Suporte a transações
Interface web de monitoramento
🤝 Contribuição
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
📝 Changelog
v1.1.0 (2025-01-XX)
✨ Arquitetura otimizada com SOLID
🔒 Validação e segurança aprimoradas
🚀 Performance melhorada
📚 Documentação expandida
v1.0.0 (2025-01-XX)
🎉 Versão inicial
🔧 Implementação básica MCP
🗄️ Suporte MySQL completo
📄 Licença
MIT License - veja o arquivo LICENSE para detalhes.
Criado com ❤️ para demonstrar o protocolo MCP da Anthropic