mysql-mcp-universal

🚀 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

• Instalar dependencias:

  npm install
  

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

• 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

Changelog

[2.2.0] - Planificado

• Soporte para PostgreSQL
• Interfaz web opcional
• Backup automático de configuraciones

Formato basado en Keep a Changelog