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:
- 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:
- En una terminal separada, inicie el servidor de autenticación:
- 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:
Para ejecutar pruebas:
Licencia
Licencia MIT
Contribuyendo
¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.