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

Variable	Descripción	Ejemplo
EMAIL_USER	Correo de Gmail para envío	menymedia@gmail.com
EMAIL_PASS	Contraseña de aplicación Gmail	icph zmog qhlc nocx
MCP_TOKEN	Token secreto para autenticación	my-secret-token

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