🤼‍♂️ Damien Email Luchador

La plataforma de inteligencia de correo electrónico basada en IA

Damien Email Wrestler es una plataforma de inteligencia de correo electrónico de IA de nivel empresarial que transforma la forma en que gestiona el correo electrónico a través de asistentes de IA de lenguaje natural como Claude. Construido con arquitectura híbrida CLI + AWS Lambda, inteligencia de IA avanzada, optimización de costes e integración MCP sin fisuras.

✨ Estado actual: Flujo de trabajo mejorado completo v0.4.2 🎉

🏆 Plataforma completa de inteligencia de correo electrónico de IA con interfaz de lenguaje natural

48 Herramientas optimizadas: Suite de gestión de correo electrónico mejorada con organización en lenguaje natural y limpieza inteligente
✅ FLUJO DE TRABAJO MEJORADO VALIDADO: 282 correos electrónicos de marketing procesados con un 100% de precisión a través de pruebas de producción
Arquitectura híbrida: Fiabilidad de la CLI + mejora de la IA de AWS Lambda cuando se configura
Probadoen el mundo real: 100-500 correos electrónicos analizados con un 83-86% de confianza en la detección de patrones
Orientación de precisión: Análisis de IA → ID de correo electrónico → Operaciones masivas precisas (cero falsos positivos)
Diseño Privacy-First: Almacenamiento exclusivo de metadatos con limpieza automática de TTL (30-90 días)
Rentabilidad: 0,01 $ por análisis de 100 correos electrónicos, ~1 $/mes para un solo usuario
Calidad empresarial: Protección de la privacidad, arquitectura escalable, graceful fallback

lo que hace especial a Damien

Gestión del correo electrónico en lenguaje natural: "Crear una regla para archivar boletines" → Se hace automáticamente
Procesamiento híbrido de IA: Fiabilidad CLI + mejora de AWS Lambda para análisis de nivel empresarial
Validado en el mundo real: cobertura de automatización del 83% con detección de patrones del 92% de confianza
Arquitectura en la que prima la privacidad: Almacenamiento solo de metadatos, cero exposición al contenido del correo electrónico
Optimización de costes: 0,01 dólares por análisis de 100 correos electrónicos con AWS Lambda de pago por solicitud
Escalabilidad empresarial: gestiona conjuntos de datos de más de 66 000 correos electrónicos con procesamiento inteligente por lotes
Inteligencia en tiempo real: 14.49 segundos por análisis de 100 correos electrónicos con la mejora de Lambda

🎯 Capacidades principales

🧠 Suite de inteligencia de IA

📊Análisis de correo electrónico: Detecta patrones, sentimiento e impacto en el negocio a través de miles de correos electrónicos
🤖 Automatización inteligente: Creación de reglas en lenguaje natural - "Archivar correos electrónicos de boletines"
💡 Información inteligente: Análisis de tendencias, métricas de eficiencia y recomendaciones de optimización
⚡Optimización de la bandeja de entrada: Estrategias de desorden y organización impulsadas por IA
🔍 Búsqueda avanzada: Búsqueda semántica con comprensión del contexto mejorada por RAG

gestión completa del correo electrónico

Gestión de conversaciones: Operaciones a nivel de conversación con contexto completo
Ciclo de vida de borradores: Cree, edite, envíe y gestione borradores sin problemas
Operaciones masivas: Procese miles de correos electrónicos de forma eficaz con seguimiento del progreso
Filtrado inteligente: Automatización sofisticada basada en reglas con mejora ML
Gestión de etiquetas: Categorización y organización inteligentes

🛡️ Funciones para empresas

Protección de la privacidad: 99,9% de precisión en la detección de información personal con tokenización reversible
Supervisión de costes: Seguimiento del uso de tokens en tiempo real con alertas configurables
Optimización delrendimiento: Enrutamiento inteligente de modelos (gpt-4o-mini frente a gpt-4o)
Cumplimiento de auditorías: Preparado para GDPR/CCPA/HIPAA con registros de auditoría inmutables
Arquitectura escalable: Gestión de cargas de trabajo empresariales con procesamiento por lotes inteligente

🏗️ Visión general de la arquitectura híbrida

Damien Email Wrestler consta de componentes integrados con procesamiento híbrido CLI + AWS Lambda:

┌─────────────────┐ ┌─────────────────────┐ ┌──────────────────┐ ┌─────────────┐ │ │ │ │ │ │ │ │ Asistente de IA │◄──►│ Adaptador de Smithery   │◄──►│ Damien MCP │◄──►│ API de Gmail │ │ (Claude) │ │ (Puerto 8081) │ │ Servidor │ │ │ │ │ │    │ │ │ (Puerto 8892) │ │ │ └─────────────────┘ └─────────────────────┘    └──────────────────┘ └─────────────┘ │ │ │ ▼ ▼ ┌─────────────────────┐
                       ┌─────────────────┐ │ Procesamiento híbrido │ │ │ Capa │ │ Smithery │ │ - CLI estándar │◄──────┐ │ Registro │ │ - Privacy Guard │ │
                       │ │ │ - Enrutador inteligente │ │ └─────────────────┘ │ - Procesador por lotes │ │ └─────────────────────┘ │ │ │ ▼ │ ┌──────────────────────────┐ │ │ │ Mejora de AWS Lambda │ │ │ (Cuando se establecen las credenciales)   │ │ │ - Procesador de correo electrónico │ │ │ - Analizador de IA (85%+) │ │ │ - Motor de reglas │ │ └──────────────────────────┘ │ │ │ │ │ ▼ │ ┌──────────────────────────┐ │ │ Privacidad-First Storage │ │ │ - Metadata Only │ │ │ - TTL Auto-Cleanup │──────┘ │ - DynamoDB Tables │ │ - No Content Storage │ └──────────────────────────┘

Desglose de componentes

🤖 Servidor MCP de Damián (puerto 8892)

48 Herramientas MCP optimizadas: Conjunto de herramientas de gestión de correo electrónico centrado siguiendo el principio de Pareto
Procesamiento híbrido: Análisis CLI estándar + mejora de la IA de AWS Lambda (cuando se configura)
Graceful Fallback: Funcionalidad completa sin AWS - Lambda mejora pero nunca es necesario
Backend FastAPI: API asíncrona de alto rendimiento con monitorización exhaustiva
Seguridad empresarial: OAuth 2.0, limitación de velocidad, registro de auditoría

adaptador de Smithery (puerto 8081)

Puente de protocolo MCP: Perfecta integración con los asistentes de IA
Descubrimiento de herramientas: Registro dinámico de herramientas y anuncio de capacidades
Gestión de errores: Fallbacks y mecanismos de reintento
Optimización del rendimiento: Agrupación de conexiones y almacenamiento en caché

🧠 Capa híbrida de inteligencia artificial

Procesamiento estándar: Análisis basado en CLI siempre disponible con detección de patrones
Mejora de Lambda: Clasificación de IA de nivel empresarial cuando se configuran las credenciales de AWS
Guardián de la privacidad: Protección PII y tokenización de nivel empresarial
Enrutador de inteligencia: Selección de modelos impulsada por ML para la optimización de costes
Motor RAG: búsqueda semántica con incrustación vectorial para la comprensión contextual
Procesador por lotes: Procesamiento escalable de grandes volúmenes de correo electrónico con seguimiento del progreso

☁️ Capa de mejora de AWS Lambda

Procesador de correo electrónico: Extracción y almacenamiento de metadatos seguros para la privacidad
Analizador de IA: Clasificación de correo electrónico de alta confianza (precisión superior al 85%)
Motor de reglas: ejecución inteligente de reglas con resolución de conflictos
Almacenamiento DynamoDB: Almacenamiento exclusivo de metadatos con limpieza automática de TTL (30-90 días)
Optimización de costes: Modelo de pago por solicitud (~$1/mes para un solo usuario)

inicio rápido

Requisitos previos

Python 3.11+ con Poetry
Node.js 18+ con npm
Credenciales de la API de Gmail(guía de configuración)
Clave de la API de OpenAI (para las funciones de IA)
Credenciales de AWS (opcional - para la mejora de Lambda)(Guía de configuración)

1. Instalación (2 minutos)

# Clona el repositorio git clone https://github.com/your-org/damien-email-wrestler.git cd damien-email-wrestler # Configura el entorno cp .env.example .env # Añade tus credenciales de Gmail y la clave API de OpenAI a .env # Instalar dependencias cd damien-cli && poetry install && cd .. cd damien-mcp-server && poetry install && cd .. cd damien-smithery-adapter && npm install && cd .

2. Iniciar servicios (30 segundos)

# Iniciar todos los servicios con un comando ./scripts/start-all.sh

Salida esperada: ✅ Todos los servicios funcionando con comprobaciones de salud pasadas

3. Conectar Claude Desktop (2 minutos)

Añada a su ~/.claude/claude_desktop_config.json:

{ "mcpServers": { "damien-email-wrestler": { "command": "node", "args": ["./damien-smithery-adapter/dist/index.js"], "cwd": "/path/to/damien-email-wrestler", "env": { "DAMIEN_MCP_SERVER_URL": "http://localhost:8892", "DAMIEN_MCP_SERVER_API_KEY": "your-api-key-from-.env" } } }

4. Prueba de integración (1 minuto)

# Autenticarse con Gmail cd damien-cli && poetry run damien login # Ejecutar pruebas de validación cd .. && ./run_e2e_tests.sh

🎉 ¡Ya estás listo! Prueba en Claude Desktop: "Listar mis correos recientes y sugerir 3 reglas de automatización"

💡 Ejemplos de uso

Gestión de correos electrónicos en lenguaje natural

Tú: "Analiza mis correos electrónicos de la última semana y encuentra patrones" Claude: [Usa damien_ai_analyze_emails] Encuentra 3 patrones clave: - 15 correos electrónicos de boletines (sugiere regla de archivado automático) - 8 solicitudes de reunión (sugiere integración de calendario) - 12 correos electrónicos de atención al cliente (sugiere etiquetado prioritario) Tú: "Crear una regla para archivar automáticamente los boletines de noticias" Claude: [Utiliza damien_ai_create_rule] Regla creada con un 95 % de confianza: ✅ Archivar automáticamente los correos electrónicos que contienen "cancelar suscripción" de dominios de marketing Usted: "Optimizar mi bandeja de entrada para mejorar la productividad"  
Claude: [Utiliza damien_ai_optimize_inbox] Optimización completada: - Archivados 47 boletines antiguos - Etiquetados 23 correos como "Acción requerida" - Creados 3 filtros inteligentes para la organización automática

Operaciones avanzadas de correo electrónico

# Uso de CLI poetry run damien emails list --query "from:boss@company.com" --max-results 10 poetry run damien ai analyze-emails --days 30 --min-confidence 0.8 poetry run damien rules suggest --categories "productivity,automation" # Bulk Operations poetry run damien emails bulk-label --query "is:unread older_than:30d" --label "Archive" poetry run damien emails bulk-trash --query "category:promotions older_than:90d" --dry-run

📊 O ptimización del rendimiento y los costes

Eficiencia de costes

Enrutamiento inteligente de modelos: Utiliza automáticamente gpt-4o-mini (un 90% más barato) para tareas sencillas
AWS Lambda: Modelo de pago por petición con escalado automático
Optimización de tokens: el parámetro include_headers reduce las llamadas a la API en más de un 80
Optimización deconsultas: Orientación inteligente de categorías de correo electrónico específicas
Supervisión en tiempo real: Seguimiento de costes con alertas configurables
Costes reales: 0,01 $ por análisis de 100 correos electrónicos, ~1 $/mes por usuario único

Métricas de rendimiento (probadas en el mundo real)

Análisis de correo electrónico: 100 correos electrónicos en 14,49 segundos (6,9 correos electrónicos/segundo) ✅
✅ FLUJO DE TRABAJO MEJORADO: 282 correos electrónicos de marketing dirigidos con precisión y desechados en 100/200/500 pruebas de correo electrónico ✅
Orientación precisa: 100% de precisión: todos los correos electrónicos identificados por IA se procesan correctamente ✅
Detección de patrones: 83-86% de confianza en la clasificación de boletines/promocionales con validación estadística ✅
Procesamiento escalable: Manejo sin problemas de 100-500 correos electrónicos con flujo de trabajo asíncrono ✅
Mejora de Lambda: 85%+ de precisión para clasificación de alta confianza ✅
Procesamiento Lambda: Menos de 300 ms por llamada a función ✅
Respuesta de la API de Gmail: < 2 segundos ✅
Ejecución de herramientas MCP: < 5 segundos por operación ✅
Uso de memoria: < 1 GB durante el funcionamiento normal ✅

Escalabilidad

Procesamiento por lotes: Maneje más de 100K correos electrónicos con chunking inteligente
Operaciones progresivas: Retroalimentación en tiempo real para tareas de larga ejecución
Operaciones paralelas: Procesamiento multihilo con seguimiento del progreso
Gestión de recursos: Limpieza y recogida de basura automáticas
Estado del servicio: Supervisión exhaustiva con reinicios automáticos

🛡️ Seguridad y privacidad

Protección de la privacidad

Almacenamiento sólo de metadatos: No se almacena contenido de correo electrónico, solo metadatos seguros para la privacidad
Privacidad de AWS Lambda: Procesamiento en la nube con exposición cero al contenido
Expiración automática de datos: Limpieza basada en TTL (30-90 días)
99.9% Detección PII: Reconocimiento avanzado de patrones para datos sensibles
Tokenización reversible: Procesamiento seguro manteniendo la recuperabilidad
Registros de auditoría: Registro inmutable para cumplimiento de normativas y depuración

Cumplimiento empresarial

Preparado para el GDPR: Gestión del consentimiento para el tratamiento de datos y derecho de supresión
Conformidad con CCPA: Cumplimiento de la ley de privacidad de California integrado
Consideraciones sobre la HIPAA: Patrones de protección de datos sanitarios
Control de acceso: Permisos basados en roles y gestión de claves API

Funciones de seguridad

OAuth 2.0: Autenticación estándar del sector con las API de Google
Limitación de tarifas: Evita los abusos y garantiza un uso justo
Gestión de errores: Fallos de gracia sin exponer datos sensibles
Almacenamiento cifrado: Todas las credenciales y tokens almacenados de forma segura

documentación

Guía de inicio rápido - Póngase en marcha en 15 minutos
Referencia de la API - Documentación completa de la herramienta
Solución de problemas - Problemas comunes y soluciones
Guía de pruebas E2E - Lista de comprobación de validación de producción

🔧 Configuración avanzada

Variables de entorno

# Configuración de la inteligencia AI AI_MODEL_STRATEGY="cost_optimized" # cost_optimized | performance_optimized | balanced USE_OPENAI_API=true # Utilizar la API de OpenAI frente a modelos locales TRACK_TOKEN_USAGE=true # Activar la supervisión de costes COST_ALERT_THRESHOLD_USD=10.00 # Alerta cuando los costes superan el umbral # Ajuste del rendimiento MAX_TOKENS_PER_REQUEST=4000 # Límite de tokens por llamada a la API SIMPLE_TASK_MAX_TOKENS=1000 # Umbral de uso de gpt-4o-mini COMPLEX_TASK_MIN_CONFIDENCE=0.8 # Umbral de uso de gpt-4o # Privacidad y seguridad PII_DETECTION_ENABLED=true # Activar la protección de PII AUDIT_LOGGING_ENABLED=true # Activar el registro de conformidad CONSENT_REQUIRED=false # Requerir consentimiento explícito para el procesamiento

Gestión de servicios

# Inicio/parada de servicios ./scripts/start-all.sh Inicio de todos los servicios ./scripts/stop-all.sh Parada de todos los servicios Salud del servicio curl http://localhost:8892/health Salud del servidor MCP curl http://localhost:8081/health Salud del adaptador Smithery Registros tail -f logs/damien-mcp-server.log Registros del servidor MCP tail -f logs/smithery-adapter.log Registros del adaptador tail -f logs/token_usage.json Registros de seguimiento de costes

🏆 ¿Por qué elegir Damien?

para particulares

Ahorro de tiempo: Automatiza el 80% de las tareas rutinarias de correo electrónico
Inteligencia: Perspectivas impulsadas por IA y detección de patrones
Control: Comandos en lenguaje natural con un control preciso
Privacidad: Protección de nivel empresarial para correos electrónicos personales

para equipos y organizaciones

Escalabilidad: Gestiona miles de correos electrónicos entre los miembros de un equipo
Conformidad: Registros de auditoría integrados y protección de la privacidad
Rentabilidad: El uso optimizado de la IA ahorra un 80% en costes de API
Integración: Conexión sin fisuras con los flujos de trabajo existentes

para desarrolladores

Protocolo MCP: Integración estándar con los asistentes de IA
Extensible: 48 herramientas con sencillas opciones de personalización
Integración con AWS: Funciones Lambda sin servidor con almacenamiento DynamoDB
Arquitectura híbrida: CLI + procesamiento en la nube para un rendimiento óptimo
Preparado para la empresa: Arquitectura y monitorización de nivel de producción

📈 Hoja de ruta

Actual (v0.4.2) - ✅ Flujo de trabajo mejorado completo

✅ PROCESAMIENTO MEJORADO DE CORREOS ELECTRÓNICOS: implementación en 3 semanas de un sistema preciso de orientación de ID de correo electrónico
✅ PRODUCCIÓN VALIDADA: 282 correos electrónicos de marketing procesados con un 100% de precisión en todas las escalas de prueba
✅ Almacenamiento en caché inteligente: desalojo LRU/LFU con optimización TTL para operaciones repetidas
✅ Procesamiento de trabajos asíncronos: Manejo sin fisuras de grandes conjuntos de datos con seguimiento del progreso en tiempo real
✅ Conjunto de herramientas MCP mejoradas (48 herramientas en total: 39 principales + 2 de basura mejoradas + 5 de organización + 2 de limpieza inteligente)
✅ CLI híbrida + arquitectura de mejora de IA de AWS Lambda
✅ Almacenamiento de metadatos de solo privacidad con limpieza TTL
✅ Validación en el mundo real: entre 100 y 500 correos electrónicos con detección de patrones con un 83-86% de confianza
✅ Focalización de precisión: Análisis de IA → ID de correo electrónico → Operaciones masivas precisas
✅ Rentabilidad: 0,01 dólares por cada análisis de 100 correos electrónicos
✅ Escalabilidad empresarial: gestiona conjuntos de datos de más de 66k correos electrónicos
✅ Graceful fallback: Funcionalidad completa sin dependencia de AWS

Próxima versión (v0.5.0) - primer trimestre de 2025

🔄 Funciones de colaboración en tiempo real
🔄 Panel de análisis avanzado
compatibilidad con varias cuentas de Gmail
🔄 Entrenamiento personalizado de modelos de inteligencia artificial
🔄 Compatibilidad mejorada con dispositivos móviles

Fase de desarrollo (v0.6.0 - v0.9.x) - Q2-Q4 2025

📅 Compatibilidad con varios proveedores (Outlook, Yahoo)
📅 Integración con Slack y Teams
📅 Automatización avanzada del flujo de trabajo
📅 Gestión predictiva del correo electrónico
📅 Consola de administración para empresas
📅 Fortalecimiento y optimización de la producción

Versión pública (v1.0.0) - primer trimestre de 2026

🚀 Primera versión pública
🚀 Documentación y soporte completos
🚀 Listo para el despliegue empresarial
🚀 Lanzamiento de la comunidad y el ecosistema

🤝 Soporte y comunidad

Issues: GitHub Issues
Documentación: Este repositorio y las guías vinculadas
Debates: Debates en GitHub
Seguridad: Correo electrónico security@damien-platform.com para problemas de seguridad

📄 Licencia

NO Licencia - ver LICENCIA para más detalles.

🙏 Agradecimientos

Construido con:

Model Context Protocol (MCP) - estándar de integración de asistentes de IA
Smithery - registro y descubrimiento de herramientas MCP
FastAPI - Framework web de Python de alto rendimiento
OpenAI: modelos lingüísticos e incrustaciones de IA
API de Gmail: integración de servicios de correo electrónico

Transforme su experiencia de correo electrónico con inteligencia impulsada por IA. Bienvenido al futuro de la gestión del correo electrónico. 🚀

Servidor	Resumen	Acciones
Servidor MCP Digital Samba Embedded API	Utilice su asistente de inteligencia artificial para interactuar con la API Digital Samba Embedded	Ver
Localizador	un servidor mcp para interactuar con la cadena	Ver
BGG MCP		Ver
Servidor MCP MQTT de Coreflux	Se trata de un servidor de Protocolo de Contexto de Modelo (MCP) que se conecta a un broker MQTT de...	Ver
chakoshi Servidor MCP	MCPクライアントアプリケーションと、chakoshi API を連携するMCP (Model Context Protocol) サーバーです...	Ver
Gestión de Apex X (Twitter)		Ver