Package Exports

mysql-mcp-server-v1
mysql-mcp-server-v1/src/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (mysql-mcp-server-v1) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

🚀 MySQL Node MCP Server

Um servidor MCP (Model Context Protocol) para monitoramento e interação com MySQL Database, desenvolvido em Node.js com suporte a múltiplas conexões simultâneas.

✨ Funcionalidades Principais

🔗 Múltiplas Conexões - Conecte-se a vários bancos MySQL simultaneamente
📊 Monitoramento - Saúde do banco, performance e métricas em tempo real
🛡️ Segurança - Validação de scripts de migração e operações seguras
⚡ Performance - Pool de conexões otimizado para cada ambiente
🔧 Administração - DDL, DML e DCL operations completas
📱 Integração - Compatível com Cursor IDE e Claude Desktop

🚀 Início Rápido

1. Instalação

npm install -g mysql-mcp-server-v1

2. Configuração MCP (Cursor/Claude Desktop)

Adicione a seguinte configuração ao seu arquivo mcp.json:

{
  "mcpServers": {
    "mysql-monitor": {
      "command": "npx",
      "args": ["mysql-mcp-server-v1@latest"],
      "env": {
        "MCP_SERVER_NAME": "mysql-monitor",
        "MCP_SERVER_VERSION": "1.0.0",
        "LOG_LEVEL": "info",
        "MYSQL_CONNECTIONS": "{\"connections\":{\"prod\":{\"host\":\"localhost\",\"port\":3306,\"user\":\"seu_usuario\",\"password\":\"sua_senha\",\"database\":\"seu_banco\",\"description\":\"Production Database\"}},\"defaultConnection\":\"prod\"}"
      }
    }
  }
}

Para múltiplas conexões:

{
  "mcpServers": {
    "mysql-monitor": {
      "command": "npx",
      "args": ["mysql-mcp-server-v1@latest"],
      "env": {
        "MCP_SERVER_NAME": "mysql-monitor",
        "MCP_SERVER_VERSION": "1.0.0",
        "LOG_LEVEL": "info",
        "MYSQL_CONNECTIONS": "{\"connections\":{\"hml\":{\"host\":\"servidor_hml\",\"port\":3306,\"user\":\"usuario_hml\",\"password\":\"senha_hml\",\"database\":\"hml_db\",\"description\":\"Homologação Database\"},\"prod\":{\"host\":\"servidor_prod\",\"port\":3306,\"user\":\"usuario_prod\",\"password\":\"senha_prod\",\"database\":\"prod_db\",\"description\":\"Production Database\"}},\"defaultConnection\":\"prod\"}"
      }
    }
  }
}

3. Configuração Automática (Opcional)

# Configurar Cursor IDE automaticamente
npx mysql-mcp-server-v1 setup-cursor

# Diagnosticar problemas de conectividade
npx mysql-mcp-server-v1 diagnose

# Testar conexão MySQL
npx mysql-mcp-server-v1 test-connection

🛠️ Ferramentas Disponíveis

🔗 Múltiplas Conexões

list_connections - Lista todas as conexões
test_connection - Testa conexão específica
test_all_connections - Testa todas as conexões
get_connections_status - Status das conexões ativas

📊 Monitoramento

check_database_health - Verifica saúde do banco
monitor_schema_changes - Monitora mudanças em esquemas
check_sensitive_tables - Verifica tabelas sensíveis
detect_suspicious_activity - Detecta atividades suspeitas

🔧 Administração

DDL: create_table, alter_table, drop_table
DML: select_data, insert_data, update_data, delete_data
DCL: create_user, grant_privileges, revoke_privileges

🔍 Análise

get_table_info - Informações detalhadas da tabela
get_constraints - Lista constraints
get_foreign_keys - Lista chaves estrangeiras
get_indexes - Lista índices
analyze_table - Analisa tabela e gera estatísticas

📋 Pré-requisitos

Node.js 18.0.0 ou superior
MySQL 5.7 ou superior / MariaDB 10.3 ou superior
Acesso ao banco com privilégios adequados

🤝 Contribuição

Contribuições são bem-vindas! Consulte o arquivo CONTRIBUTING.md para mais detalhes.

📄 Licença

Este projeto está licenciado sob a Licença MIT - veja o arquivo LICENSE para detalhes.

🆘 Suporte

Para suporte e dúvidas:

Consulte a documentação completa
Abra uma issue no GitHub
Verifique os logs para erros específicos

Desenvolvido com ❤️ por Leandro Ferreira