MCP 服务器

MySQL MCP Server (Optimized)

An MCP server for MySQL that enables users to execute SQL queries, inspect table structures, and explore database schemas through a clean, SOLID-based architecture. It includes built-in security validations to protect against dangerous operations and ensure safe interaction with database resources.

README

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

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

🎯 Conceitos MCP Implementados

1. Tools (Ferramentas)

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

2. Resources (Recursos)

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

3. Prompts (Templates)

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

🚀 Instalação e Uso

1. Instalar Dependências

npm install

2. Configurar MySQL

Crie um arquivo .env:

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

3. Compilar e Executar

# Compilar
npm run build

# Executar
npm start

# Desenvolvimento
npm run dev

4. Testar Conexão

npm run test:connection

🔧 Configuração Claude Desktop

Adicione ao claude_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"
      }
    }
  }
}

🛡️ 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

// 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"
  }
}