Servidor MCP de la API de Nylas

Servidor MCP de la API de Nylas (experimental)

Nota : Este proyecto es experimental y su propósito es explorar el uso del Protocolo de Contexto de Modelo (MCP) como guía para la integración de la API de Nylas. No es oficial y debe usarse únicamente con fines de aprendizaje y experimentación.

Este proyecto implementa un servidor de Protocolo de Contexto de Modelo (MCP) para la API de Nylas. Proporciona recursos, herramientas y sugerencias para ayudar a los desarrolladores a comprender e integrar la API de Nylas para las funciones de correo electrónico, calendario y contactos.

¿Qué es MCP?

El Protocolo de Contexto de Modelo (MCP) es un estándar para integrar datos, herramientas e indicaciones con aplicaciones de IA. Los servidores MCP pueden exponer recursos, herramientas e indicaciones a aplicaciones de IA como Claude Desktop , Cursor y otras compatibles con MCP.

Características

Este servidor MCP proporciona:

Recursos de documentación : documentación completa sobre los puntos finales de la API de Nylas, la autenticación y las mejores prácticas
Ejemplos de código : ejemplos de código listos para usar para diversas operaciones de la API de Nylas en varios lenguajes (Node.js, Python, Java, Ruby, curl)
Herramientas interactivas : herramientas para generar código de autenticación y código de implementación específico del punto final
Avisos : Avisos prediseñados para escenarios comunes de integración de Nylas

Empezando

Prerrequisitos

Node.js 18+
npm

Instalación

Clonar este repositorio
Instalar dependencias

npm install

Construir el proyecto

npm run build

Ejecución del servidor MCP

Uso de stdio (para integración directa con clientes MCP)

npm start

Uso de HTTP con SSE (para conexiones remotas)

MCP_MODE=http npm start

De forma predeterminada, el servidor HTTP se ejecuta en el puerto 3000. Puede cambiar esto configurando la variable de entorno PORT :

MCP_MODE=http PORT=8080 npm start

Uso con clientes MCP

Escritorio de Claude

Inicie el servidor MCP en modo stdio
En Claude Desktop, vaya a Configuración > Servidores
Haga clic en "Agregar servidor"
Seleccione "Ejecutar un comando local" e ingrese el comando para iniciar este servidor:

node /path/to/nylas-api-mcp/dist/index.js

Dale un nombre (por ejemplo, "API de Nylas")
Después de agregar, puedes usar todos los recursos, herramientas y mensajes de la API de Nylas en tus conversaciones de Claude

Cursor

Inicie el servidor MCP en modo stdio
En Cursor, agregue un nuevo servidor MCP en la configuración
Configúrelo para utilizar el comando:

node /path/to/nylas-api-mcp/dist/index.js

Recursos

Este servidor MCP proporciona los siguientes recursos:

Documentación general : Descripción general de las capacidades de la API de Nylas
Guía de autenticación : Cómo autenticarse con la API de Nylas
Puntos finales de API : documentación para puntos finales de correo electrónico, calendario, contactos y webhook
Ejemplos de código : ejemplos de uso en varios lenguajes de programación

Herramientas

Herramientas interactivas para la generación de código:

generate-auth-code : genera un código de autenticación en su idioma preferido
generate-endpoint-code : genera código para puntos finales de API específicos
search-api-docs : Busque en la documentación de la API de Nylas

Indicaciones

Indicaciones predefinidas para escenarios comunes:

Introducción básica a la API de Nylas
Guía de autenticación : Comprensión del flujo de OAuth
Integración de correo electrónico, calendario y contactos : orientación específica para cada función
Escenarios de integración : orientación para casos de uso específicos (cliente de correo electrónico, reserva de calendario, etc.)
Ejemplos de SDK : código de ejemplo en varios idiomas
Guía de depuración : problemas comunes y soluciones

Contribuyendo

¡Agradecemos sus contribuciones! Puede:

Agregue más ejemplos de código al directorio nylas-code-samples
Mejorar los recursos de documentación
Añadir soporte para lenguajes de programación adicionales
Crear nuevas herramientas y avisos

Descargo de responsabilidad

Este es un proyecto experimental y Nylas no ofrece soporte oficial. La información y el código proporcionados a través de este servidor MCP deben utilizarse únicamente como recurso de aprendizaje. Consulte siempre la documentación oficial de Nylas para obtener la información más precisa y actualizada sobre la API de Nylas.

El código de muestra proporcionado es para fines educativos y puede requerir manejo de errores adicionales, consideraciones de seguridad y pruebas antes de ser utilizado en entornos de producción.

Licencia

Instituto Tecnológico de Massachusetts (MIT)

Nylas API MCP Server

Integrations