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

Related MCP server: Gmail MCP Server

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

1. Clonar el repositorio:

   git clone https://github.com/your-username/enhanced-outlook-mcp.git
   cd enhanced-outlook-mcp

2. Instalar dependencias:

   npm install

3. 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

1. 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"
         }
       }
     ]
   }

2. Inicie el servidor MCP:

   npm start

3. En una terminal separada, inicie el servidor de autenticación:

   npm run auth-server

4. Utilice la herramienta de autenticación en Claude para iniciar el flujo de autenticación.

Flujo de autenticación

1. Inicie el servidor de autenticación en el puerto configurado (predeterminado: 3333)

2. Utilice la herramienta authenticate para obtener una URL de autenticación

3. Complete la autenticación en su navegador

4. 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.