Servidor MCP de Outlook mejorado

Se trata de una implementación modular mejorada del servidor MCP (Protocolo de Contexto de Modelo) de Outlook que conecta a Claude con Microsoft Outlook mediante la API de Microsoft Graph. Este servidor proporciona un conjunto completo de herramientas para correo electrónico, calendario, gestión de carpetas y creación de reglas.

Características

Sistema de autenticación completo : autenticación OAuth 2.0 con API de Microsoft Graph con actualización de token y soporte para múltiples usuarios
Gestión de correo electrónico : enumere, busque, lea, envíe y organice correos electrónicos con soporte para archivos adjuntos
Integración de calendario : cree, modifique y administre eventos de calendario con seguimiento de asistentes
Organización de carpetas : cree, administre y navegue por carpetas de correo electrónico
Motor de reglas : cree y administre reglas complejas de procesamiento de correo
Arquitectura modular : separación clara de preocupaciones para una mejor mantenibilidad y extensibilidad
Manejo de errores mejorado : mensajes de error detallados y registro
Modo de prueba : respuestas simuladas para realizar pruebas sin llamadas API reales
Limitación de velocidad : evite la limitación de la API con limitación de velocidad integrada
Configuración multientorno : Compatibilidad con entornos de desarrollo, prueba y producción

Estructura del directorio

/enhanced-outlook-mcp/
├── index.js                     # Main entry point
├── config.js                    # Configuration settings
├── .env.example                 # Example environment variables
├── auth/                        # Authentication modules
│   ├── index.js                 # Authentication exports
│   ├── token-manager.js         # Token storage and refresh
│   ├── multi-user-support.js    # Multiple user support
│   └── tools.js                 # Auth-related tools
├── email/                       # Email functionality
│   ├── index.js                 # Email exports
│   ├── list.js                  # List emails
│   ├── search.js                # Search emails
│   ├── read.js                  # Read email
│   ├── send.js                  # Send email
│   └── attachments.js           # Handle email attachments
├── calendar/                    # Calendar functionality
│   ├── index.js                 # Calendar exports
│   ├── create-event.js          # Create calendar events
│   ├── list-events.js           # List calendar events
│   ├── update-event.js          # Update calendar events
│   └── delete-event.js          # Delete calendar events
├── folder/                      # Folder management
│   ├── index.js                 # Folder exports
│   ├── list.js                  # List folders
│   ├── create.js                # Create folders
│   └── move.js                  # Move items between folders
├── rules/                       # Mail rules functionality
│   ├── index.js                 # Rules exports
│   ├── create.js                # Create mail rules
│   ├── list.js                  # List mail rules
│   └── delete.js                # Delete mail rules
└── utils/                       # Utility functions
    ├── graph-api.js             # Microsoft Graph API helper
    ├── odata-helpers.js         # OData query building
    ├── logger.js                # Logging utility
    ├── rate-limiter.js          # API rate limiting
    └── mock-data/               # Test mode mock data
        ├── emails.js            # Mock email data
        ├── folders.js           # Mock folder data
        ├── calendar.js          # Mock calendar data
        └── rules.js             # Mock rules data

Instalación

Clonar el repositorio:
git clone https://github.com/your-username/enhanced-outlook-mcp.git cd enhanced-outlook-mcp
Instalar dependencias:
npm install
Cree un archivo .env basado en .env.example con los detalles de registro de su aplicación de Microsoft:
MS_CLIENT_ID=your_client_id MS_CLIENT_SECRET=your_client_secret # Additional configuration options

Uso con Claude

Configure Claude para usar el servidor MCP agregando lo siguiente a su configuración de Claude:
{ "tools": [ { "name": "enhanced-outlook-mcp", "url": "http://localhost:3000", "auth": { "type": "none" } } ] }
Inicie el servidor MCP:
npm start
En una terminal separada, inicie el servidor de autenticación:
npm run auth-server
Utilice la herramienta de autenticación en Claude para iniciar el flujo de autenticación.

Flujo de autenticación

Inicie el servidor de autenticación en el puerto configurado (predeterminado: 3333)
Utilice la herramienta authenticate para obtener una URL de autenticación
Complete la autenticación en su navegador
Los tokens se almacenan de forma segura en la ubicación configurada

Desarrollo

Para ejecutar el servidor en modo de desarrollo con recarga automática:

npm run dev

Para ejecutar pruebas:

npm test

Licencia

Licencia MIT

Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.

Enhanced Outlook MCP Server

Integrations