Nylas API MCP 服务器（实验性）

注意：此项目是实验性的，旨在探索使用模型上下文协议 (MCP) 作为 Nylas API 集成的指南。它不是官方版本，仅用于学习和实验目的。

该项目实现了 Nylas API 的模型上下文协议 (MCP) 服务器。它提供了资源、工具和提示，帮助开发人员了解和集成 Nylas API 以实现电子邮件、日历和联系人功能。

什么是 MCP？

模型上下文协议 (MCP) 是一种将数据、工具和提示与 AI 应用程序集成的标准。MCP 服务器可以向 Claude Desktop、Cursor 等 MCP 兼容应用程序暴露资源、工具和提示。

功能

该 MCP 服务器提供：

• 文档资源：关于 Nylas API 端点、身份验证和最佳实践的全面文档
• 代码示例：多种语言（Node.js、Python、Java、Ruby、curl）的即用型 Nylas API 操作代码示例
• 交互式工具：生成身份验证代码和特定端点实现代码的工具
• 提示：常见 Nylas 集成场景的预构建提示

开始使用

前提条件

• Node.js 18+
• npm

安装

1. 克隆此仓库
2. 安装依赖项

npm install

1. 构建项目

npm run build

运行 MCP 服务器

使用 stdio（直接与 MCP 客户端集成）

npm start

使用带有 SSE 的 HTTP（远程连接）

MCP_MODE=http npm start

默认情况下，HTTP 服务器运行在 3000 端口。你可以通过设置 PORT 环境变量来更改此端口：

MCP_MODE=http PORT=8080 npm start

与 MCP 客户端一起使用

Claude Desktop

1. 以 stdio 模式启动 MCP 服务器
2. 在 Claude Desktop 中，转到设置 > 服务器
3. 单击“添加服务器”
4. 选择“运行本地命令”并输入启动此服务器的命令：

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

1. 给它一个名称（例如，“Nylas API”）
2. 添加后，你可以在 Claude 会话中使用所有 Nylas API 资源、工具和提示

Cursor

1. 以 stdio 模式启动 MCP 服务器
2. 在 Cursor 中，在设置中添加一个新的 MCP 服务器
3. 配置它使用以下命令：

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

资源

该 MCP 服务器提供以下资源：

• 通用文档：Nylas API 功能概述
• 身份验证指南：如何对 Nylas API 进行身份验证
• API 端点：电子邮件、日历、联系人和 Webhook 端点的文档
• 代码示例：多种编程语言的使用示例

工具

用于代码生成的交互式工具：

• generate-auth-code: 生成你所偏好的语言的认证代码
• generate-endpoint-code: 生成特定 API 端点的代码
• search-api-docs: 搜索 Nylas API 文档

提示

常见场景的预构建提示：

• 入门指南: Nylas API 基本介绍
• 认证指南: 理解 OAuth 流程
• 邮件/日历/联系人集成: 特定功能指导
• 集成场景: 针对特定使用案例的指导（如电子邮件客户端、日历预订等）
• SDK 示例: 各种语言的示例代码
• 调试指南: 常见问题及解决方案

贡献

欢迎贡献！你可以：

1. 在 nylas-code-samples 目录中添加更多代码示例
2. 改进文档资源
3. 增加对其他编程语言的支持
4. 创建新的工具和提示

免责声明

这是一个实验性项目，并非由 Nylas 官方支持。通过此 MCP 服务器提供的信息和代码仅应作为学习资源使用。请始终参考 官方 Nylas 文档 获取关于 Nylas API 最准确和最新的信息。

提供的示例代码仅供教育用途，在生产环境中使用前可能需要额外的错误处理、安全考虑和测试。

许可证

MIT