MySQL MCP Server

Generador de Ejecutable MySQL MCP Server

Este proyecto contiene los scripts y configuraciones necesarias para generar un ejecutable (.exe) del servidor MySQL MCP.

Requisitos Previos

1. Sistema Operativo
   • Windows 11 (64 bits)
2. Python
   • Python 3.12 o superior
   • Descargar desde python.org
   • Durante la instalación, marcar la opción "Add Python to PATH"

Instalación

1. Clonar o descargar el repositorio
   git clone <url-del-repositorio> cd <nombre-del-directorio>
2. Crear y activar un entorno virtual (opcional pero recomendado)
   python -m venv venv .\venv\Scripts\activate
3. Instalar dependencias
   pip install -r requirements.txt

Generación del Ejecutable

Paso 1: Preparación del Entorno

1. Abrir PowerShell como administrador
2. Navegar al directorio del proyecto
3. Asegurarse de que todas las dependencias estén instaladas

Paso 2: Ofuscación del Código

Este comando creará una carpeta dist con el código ofuscado.

Paso 3: Compilación del Ejecutable

Paso 4: Verificación

• El ejecutable se creará en el directorio actual
• Nombre del archivo: mysql_mcp_server_v2.exe
• Tamaño aproximado: 20-30 MB (dependiendo de las dependencias)

Paso 5: Pruebas del Ejecutable

1. Prueba Básica
   • Haz doble clic en mysql_mcp_server_v2.exe
   • Verifica que la aplicación se inicie sin errores
   • Comprueba que la ventana de la aplicación se muestre correctamente
2. Prueba desde PowerShell
   # Navega al directorio donde está el ejecutable cd ruta\al\directorio # Ejecuta el programa .\mysql_mcp_server_v2.exe
3. Verificación de Funcionalidad
   • Intenta conectarte a la base de datos MySQL
   • Verifica que todas las operaciones principales funcionen:
     • Conexión a la base de datos
     • Consultas básicas
     • Operaciones de escritura/lectura
   • Comprueba que los archivos de configuración se lean correctamente
4. Pruebas de Estabilidad
   • Deja el programa ejecutándose por varias horas
   • Realiza múltiples conexiones/desconexiones
   • Verifica el uso de memoria y CPU en el Administrador de tareas
5. Solución de Problemas Comunes
   • Si el programa no inicia:
     • Verifica que no haya bloqueos del antivirus
     • Comprueba que todos los archivos de configuración estén presentes
     • Revisa los permisos de ejecución
   • Si hay errores de conexión:
     • Verifica que el servidor MySQL esté activo
     • Comprueba las credenciales en el archivo de configuración
     • Asegúrate de que el firewall no esté bloqueando la conexión

Notas Importantes

1. Tiempo de Compilación
   • El proceso puede tardar varios minutos
   • La primera compilación puede ser más lenta debido a la descarga de dependencias
2. Archivos de Configuración
   • Si el script utiliza archivos de configuración (.env, .ini, etc.), asegúrate de que estén en la ubicación correcta
   • Los archivos de configuración deben estar en el mismo directorio que el ejecutable
3. Solución de Problemas
   • Si encuentras errores durante la compilación, verifica:
     • Que Python esté correctamente instalado y en el PATH
     • Que todas las dependencias estén instaladas
     • Que no haya errores de sintaxis en el código fuente
4. Distribución
   • El ejecutable final es independiente y no requiere Python instalado
   • Incluye todas las dependencias necesarias
   • Puede ser distribuido a otros equipos Windows sin necesidad de instalaciones adicionales

Estructura de Archivos

Soporte

Si encuentras algún problema durante el proceso de compilación o necesitas ayuda adicional, por favor:

1. Revisa los mensajes de error detalladamente
2. Verifica que todos los requisitos previos estén cumplidos
3. Asegúrate de estar usando las versiones correctas de las dependencias