🚀 MySQL MCP Universal Server

🌟 ¡La forma más fácil de conectar GitHub Copilot a cualquier base de datos MySQL al instante!

Servidor MCP (Model Context Protocol) que permite a GitHub Copilot conectarse a cualquier base de datos MySQL en cualquier servidor (local o remoto).

📖 English Documentation | Guía de Instalación | Guía Rápida

⚡ Instalación Rápida

1. Instalar dependencias:

   npm install

2. Configurar VS Code globalmente: Agregar a C:\Users\[usuario]\AppData\Roaming\Code\User\settings.json:

   "mcp": {
       "servers": {
           "mysql-universal": {
               "command": "node",
               "args": ["Q:\\laragon\\www\\mysql-connect\\main-universal.cjs"],
               "env": {
                   "MYSQL_HOST": "127.0.0.1",
                   "MYSQL_USER": "root",
                   "MYSQL_PASSWORD": "tu_password",
                   "MYSQL_PORT": "3306"
               }
           }
       }
   }

3. Reiniciar VS Code

🎯 Uso Inmediato

Abre GitHub Copilot Chat en VS Code y prueba:

• "Muestra las bases de datos disponibles"
• "Lista las tablas de la base de datos 'mi_proyecto'"
• "Describe la estructura de la tabla 'usuarios'"
• "Ejecuta: SELECT * FROM productos LIMIT 10"

🌟 Características

• ✅ Universal: Conecta a cualquier servidor MySQL
• ✅ Flexible: Parámetros dinámicos por consulta
• ✅ Inteligente: Cache de conexiones automático
• ✅ Simple: Sin configuración compleja

🔧 Herramientas Disponibles

| Herramienta | Descripción | Parámetros | |-------------|-------------|------------| | show_databases | Lista todas las bases de datos | host, port, user, password (opcionales) | | show_tables | Lista tablas de una BD | database (requerido), conexión (opcional) | | describe_table | Estructura de una tabla | table_name, database (requeridos), conexión (opcional) | | execute_query | Ejecuta consultas SQL | query, database (requeridos), conexión (opcional) |

📝 Ejemplos Avanzados

# Servidor remoto
"Conecta al servidor 192.168.1.100 puerto 3307 usuario 'admin' y muestra las bases de datos"

# Múltiples operaciones
"Lista las tablas de 'produccion' en localhost y las de 'desarrollo' en servidor remoto"

# Consultas específicas
"En la base de datos 'ventas', ejecuta: SELECT COUNT(*) FROM pedidos WHERE fecha >= '2024-01-01'"

⚙️ Configuración Opcional (.env)

MYSQL_HOST=127.0.0.1
MYSQL_USER=root
MYSQL_PASSWORD=123456
MYSQL_PORT=3306

Nota: Las variables de entorno son valores por defecto. Cada consulta puede usar parámetros diferentes.

🚀 Inicio del Servidor

# Opción 1: Script automatizado
start-universal.bat

# Opción 2: Comando directo
node main-universal.cjs

📁 Archivos del Proyecto

• main-universal.cjs - Servidor principal (CommonJS)
• package.json - Dependencias del proyecto
• .env - Variables de entorno por defecto
• start-universal.bat - Script de inicio
• README.md - Esta documentación

⚠️ Requisitos

• Node.js 18 o superior
• MySQL Server ejecutándose
• Laragon o servidor MySQL local/remoto

© 2024-2025 MySQL MCP Universal Server v2.0.1