FGJ Multimedios MCP Server

Servidor MCP para envío automático de correos institucionales de FGJ Multimedios.

Características

• ✅ Envío de correos institucionales vía SMTP (Gmail)

• ✅ Contexto personalizado para respuestas de IA

• ✅ Integración con FastMCP Cloud y desarrollo local

• ✅ Firma automática de Bélgica Jiménez (Gerente General)

🔑 Autenticación - IMPORTANTE

FastMCP Cloud y desarrollo local manejan la autenticación de manera diferente:

FastMCP Cloud (Producción)

• ❌ NO uses auth=verifier en el servidor

• ❌ NO envíes headers Authorization: Bearer desde el cliente

• ✅ FastMCP Cloud maneja la autenticación automáticamente

• ✅ Usa app.py como punto de entrada (sin autenticación)

Desarrollo Local

• ✅ Usa auth=verifier en el servidor (server.py)

• ✅ Envía Authorization: Bearer {token} desde el cliente

• ✅ Configura MCP_TOKEN en .env

Despliegue en FastMCP Cloud

Paso 1: Preparar el Repositorio

1. Asegúrate de que tu código esté en un repositorio de GitHub

2. Verifica que tengas estos archivos:

   • ✅ app.py - Punto de entrada para FastMCP Cloud (SIN autenticación)

   • ✅ requirements.txt - Dependencias completas

   • ✅ server.py - Servidor local con autenticación (para desarrollo)

Paso 2: Crear Proyecto en FastMCP Cloud

1. Ve a FastMCP Cloud e inicia sesión con tu cuenta de GitHub

2. Haz clic en "New Project" o "Crear Proyecto"

3. Selecciona tu repositorio de GitHub

4. Configura el proyecto:

   • Nombre del proyecto: fgj-multimedios-mcp (o el que prefieras)

   • Punto de entrada: app.py ⚠️ IMPORTANTE: Usar app.py, NO server.py

   • Rama: main o tu rama de desarrollo

Paso 3: Configurar Variables de Entorno

En la configuración del proyecto, añade SOLO estas variables:

EMAIL_USER=tu-correo@gmail.com
EMAIL_PASS=tu-app-password-de-gmail

⚠️ IMPORTANTE:

• EMAIL_PASS debe ser una Contraseña de Aplicación de Gmail (no tu contraseña normal)

• ❌ NO agregues MCP_TOKEN en FastMCP Cloud - no es necesario

• ✅ FastMCP Cloud maneja la autenticación automáticamente

Paso 4: Desplegar

1. Haz clic en "Deploy" o "Desplegar"

2. FastMCP Cloud construirá y desplegará tu servidor

3. Una vez completado, recibirás una URL como:

   https://tu-proyecto.fastmcp.app/api/mcp

Paso 5: Actualizar Cliente

Actualiza tu client.py para usar la URL de FastMCP Cloud:

client = MultiServerMCPClient(
    {
        "fgj-server": {
            "transport": "streamable_http",
            "url": "https://tu-proyecto.fastmcp.app/api/mcp",  # ← Cambia esto
            "headers": {
                "Authorization": f"Bearer {os.getenv('MCP_TOKEN')}"
            }
        }
    }
)

Variables de Entorno Requeridas

Uso Local

# Instalar dependencias
pip install -r requirements.txt

# Configurar variables de entorno
cp .env.example .env
# Edita .env con tus credenciales

# Ejecutar servidor
python server.py

El servidor estará disponible en http://localhost:8000/api/mcp

Herramientas Disponibles

• send_email: Envía correos institucionales

• email_context: Prompt con contexto de FGJ Multimedios

Solución de Problemas

Error de Autenticación en FastMCP Cloud

Si recibes errores 401 Unauthorized o problemas de autenticación:

1. Verifica que usas app.py como punto de entrada en FastMCP Cloud

   • app.py NO tiene autenticación (correcto para FastMCP Cloud)

   • server.py tiene autenticación (solo para desarrollo local)

2. Verifica las variables de entorno en FastMCP Cloud:

   EMAIL_USER=tu-correo@gmail.com
   EMAIL_PASS=app-password-de-gmail

   ❌ NO agregues MCP_TOKEN en FastMCP Cloud

3. Ejecuta el test de conexión:

   python test_fastmcp.py

4. Revisa los logs en FastMCP Cloud Dashboard

   • Busca errores de SMTP o autenticación

   • Verifica que el servidor esté "running"

Error de Autenticación en Local

Si tienes problemas en desarrollo local:

1. Verifica tu archivo .env:

   EMAIL_USER=tu-correo@gmail.com
   EMAIL_PASS=app-password-de-gmail
   MCP_TOKEN=tu-token-secreto

2. Inicia el servidor con autenticación:

   python server.py

3. Verifica que el cliente use localhost:

   export MCP_URL=http://localhost:8000/api
   python client.py

Archivos del Proyecto

• app.py → Para FastMCP Cloud (sin autenticación)

• server.py → Para desarrollo local (con autenticación)

• server_cloud.py → DEPRECADO (usar app.py)

• client.py → Cliente que detecta automáticamente el modo

• test_fastmcp.py → Prueba de conexión

Notas

• Cada push a la rama main redeployará automáticamente el servidor

• Los logs están disponibles en el dashboard de FastMCP Cloud

• El servidor se reinicia automáticamente si hay errores

• El cliente detecta automáticamente si conecta a FastMCP Cloud o localhost