Email Processing MCP Server

Servidor MCP de procesamiento de correo electrónico

Este servidor MCP proporciona capacidades de procesamiento de correo electrónico con integración MongoDB para búsqueda semántica y SQLite para almacenamiento y recuperación eficientes.

Características

• Procesar correos electrónicos desde Outlook con filtrado por rango de fechas
• Almacene correos electrónicos en una base de datos SQLite con una gestión de conexión adecuada
• Generar incrustaciones vectoriales usando Ollama
• Compatibilidad con varios buzones de correo
• Compatibilidad con carpetas Bandeja de entrada, Elementos enviados y, opcionalmente, Elementos eliminados

Próximas funciones

• Búsqueda de correo electrónico con capacidades semánticas
• Resumen de correo electrónico mediante LLM
• Categorización automática de correo electrónico
• Informes de correo electrónico personalizables
• Opciones de filtrado avanzadas
• Borrador de respuestas de correo electrónico de Outlook
• Sugerencias de reglas de Outlook
• Opciones de base de datos ampliadas con integración de Neo4j y ChromaDB

Prerrequisitos

• Python 3.10 o superior
• Ollama ejecutándose localmente (para incrustaciones)
• Microsoft Outlook instalado
• Sistema operativo Windows (para la integración con Outlook)
• Servidor MongoDB (para almacenar incrustaciones)

Instalación

1. Instalar uv (si aún no está instalado):

2. Crear un entorno virtual:

3. Activar el entorno virtual:Ventanas:
   .venv\Scripts\activate
   macOS/Linux:
   source .venv/bin/activate
4. Instalar dependencias:

5. Instalar el paquete fastmcp:

6. Asegúrese de que Ollama se esté ejecutando localmente con los modelos requeridos:

Configuración

Agregue el servidor a su archivo de configuración de Claude for Desktop:

• Ventanas: %APPDATA%\Claude\claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Rastreo y Monitoreo

El servidor se diseñó para admitir soluciones externas de rastreo y monitorización. La implementación del registro de MCP se eliminó intencionalmente para sustituir un enfoque de rastreo más robusto que se implementará por separado.

Nota: No intente reimplementar el sistema de registro anterior. Se proporcionará una nueva solución de rastreo próximamente.

Explicación de los campos de configuración:

• command : Ruta completa al ejecutable de Python en su entorno virtual
• args : Matriz que contiene la ruta completa al script del servidor MCP
• env : Variables de entorno para configuración
  • MONGODB_URI : cadena de conexión de MongoDB
  • SQLITE_DB_PATH : Ruta absoluta al archivo de base de datos SQLite
  • EMBEDDING_BASE_URL : URL del servidor Ollama
  • EMBEDDING_MODEL : Modelo a utilizar para incrustaciones
  • LLM_MODEL : Modelo a utilizar para operaciones LLM
  • COLLECTION_NAME : Nombre de la colección MongoDB a utilizar (obligatorio)
  • PROCESS_DELETED_ITEMS : Si se deben procesar correos electrónicos de la carpeta Elementos eliminados (opcional, valor predeterminado: "falso")
• disabled : si el servidor está deshabilitado (debe ser falso)
• alwaysAllow : Matriz de herramientas que no requieren confirmación del usuario
• autoApprove : conjunto de herramientas que pueden aprobarse automáticamente

Reemplace las rutas con las rutas reales de su sistema. Tenga en cuenta que las rutas de Windows en la sección env deben usar doble barra invertida.

Herramientas disponibles

1. procesar_correos electrónicos

Procesar correos electrónicos de un rango de fechas específico:

La herramienta hará lo siguiente:

1. Conectarse a buzones de correo de Outlook especificados
2. Recuperar correos electrónicos de las carpetas Bandeja de entrada y Elementos enviados (y Elementos eliminados si está habilitado)
3. Almacenar correos electrónicos en una base de datos SQLite
4. Generar incrustaciones usando Ollama
5. Incrustaciones de almacenes en MongoDB para búsqueda semántica

Ejemplo de uso en Claude

Arquitectura

El servidor utiliza un enfoque de búsqueda híbrido:

1. Base de datos SQLite para:
   • Almacenamiento de correo electrónico principal
   • Capacidades de búsqueda de texto completo
   • Seguimiento del estado del procesamiento
   • Filtrado eficiente
   • El directorio se crea automáticamente si no existe
   • Las conexiones se cierran correctamente para evitar el bloqueo de la base de datos.
2. MongoDB para:
   • Almacenamiento de incrustaciones vectoriales
   • Búsqueda de similitud semántica
   • Filtrado de metadatos
   • Recuperación eficiente
   • Las conexiones están correctamente cerradas después del uso.

Manejo de errores

El servidor proporciona mensajes de error detallados para problemas comunes:

• Formatos de fecha no válidos
• Problemas de conexión con Outlook
• Errores de MongoDB
• Incrustación de errores de generación con lógica de reintento
• Errores de almacenamiento de SQLite
• Problemas de conexión del servidor Ollama con reintentos automáticos

Gestión de recursos

El servidor implementa una gestión adecuada de recursos para evitar problemas:

• Las conexiones de bases de datos (SQLite y MongoDB) se mantienen abiertas durante la vida útil del servidor para evitar errores del tipo "No se puede operar en una base de datos cerrada".
• Las conexiones solo se cierran cuando el servidor se apaga, mediante un controlador atexit
• Los destructores y administradores de contexto se utilizan como respaldo para garantizar que las conexiones se cierren cuando se recolectan elementos no utilizados de los objetos.
• La gestión de la conexión está diseñada para equilibrar el uso de recursos con la confiabilidad operativa.
• Lógica de reintento robusta para servicios externos como Ollama para manejar problemas de conexión temporales

Notas de seguridad

• El servidor sólo procesa correos electrónicos de buzones específicos
• Todos los datos se almacenan localmente (SQLite) y en MongoDB
• No hay llamadas API externas excepto al servidor Ollama local
• Requiere la aprobación explícita del usuario para el procesamiento del correo electrónico
• No se exponen datos de correo electrónico confidenciales a través de la interfaz MCP

Depuración

Si encuentra problemas:

1. Verifique que los correos electrónicos se procesaron correctamente (verifique la respuesta de process_emails)
2. Asegúrese de que el servidor Ollama se esté ejecutando para la generación de incrustaciones
3. Compruebe que la base de datos SQLite sea accesible
4. Verificar que la conexión de MongoDB funcione correctamente