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](https://www.python.org/downloads/) - Durante la instalación, marcar la opción "Add Python to PATH" ## Instalación 1. **Clonar o descargar el repositorio** ```powershell git clone <url-del-repositorio> cd <nombre-del-directorio> ``` 2. **Crear y activar un entorno virtual (opcional pero recomendado)** ```powershell python -m venv venv .\venv\Scripts\activate ``` 3. **Instalar dependencias** ```powershell 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 ```powershell pyarmor gen -O dist mysql_mcp_server_v2.py esto se genera en modo trial q no funciona al querer generar el ejecutable ``` Este comando creará una carpeta `dist` con el código ofuscado. ### Paso 3: Compilación del Ejecutable ```powershell python -m nuitka --onefile --windows-disable-console --output-filename=mysql_mcp_server_v2.exe dist/mysql_mcp_server_v2.py python -m nuitka --onefile --output-filename=mysql_mcp_server_v2.exe mysql_mcp_server_v2.py se crea de esta manera para ver log de posibles errores en ejecucion del exe python -m nuitka --onefile --include-package=mysql.connector --include-package=mcp.server.fastmcp --include-package=logging --include-package=asyncio --output-filename=mysql_mcp_server_v2.exe mysql_mcp_server_v2.py se genera con los paquetes especificos ``` ### 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** ```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 ``` proyecto/ │ ├── mysql_mcp_server_v2.py # Código fuente principal ├── requirements.txt # Dependencias del proyecto ├── README.md # Este archivo ├── dist/ # Carpeta con código ofuscado │ └── mysql_mcp_server_v2.py │ └── mysql_mcp_server_v2.exe # Ejecutable final (generado) ``` ## 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