Nylas API MCP 服务器 (实验性)

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

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

什么是 MCP？

模型上下文协议 (MCP) 是一个将数据、工具和提示与 AI 应用程序集成的标准。 MCP 服务器可以向 AI 应用程序（如 Claude Desktop、Cursor 和其他 MCP 兼容的应用程序）公开资源、工具和提示。

功能

此 MCP 服务器提供：

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

快速开始

前提条件

• Node.js 18+
• npm

安装

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

npm install

3. 构建项目

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 中，转到 Settings > Servers
3. 点击 "Add Server"
4. 选择 "Run a local command" 并输入启动此服务器的命令：

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

5. 给它一个名称（例如，“Nylas API”）
6. 添加后，您可以在 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