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