MCP Server Instalador

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)

1. 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 
   cd 

1. Crear y activar un entorno virtual (opcional pero recomendado)

   python -m venv venv
   .\venv\Scripts\activate

1. 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

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

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

1. Prueba desde PowerShell

   # Navega al directorio donde está el ejecutable
   cd ruta\al\directorio
   
   # Ejecuta el programa
   .\mysql_mcp_server_v2.exe

1. 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

1. 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

1. 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

1. 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

1. 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

1. 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