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

Asegúrate de que tu código esté en un repositorio de GitHub
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

Ve a FastMCP Cloud e inicia sesión con tu cuenta de GitHub
Haz clic en "New Project" o "Crear Proyecto"
Selecciona tu repositorio de GitHub
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

Haz clic en "Deploy" o "Desplegar"
FastMCP Cloud construirá y desplegará tu servidor
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:

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)
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
Ejecuta el test de conexión:
```
python test_fastmcp.py
```
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:

Verifica tu archivo .env:

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

Inicia el servidor con autenticación:
```
python server.py
```

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