Nylas API MCP Server (实验性)

注意：此项目是实验性的，旨在探索使用模型上下文协议（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

3. 构建项目

npm run build

运行MCP服务器

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

npm start

使用HTTP与SSE（远程连接）

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

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