Nylas API MCP 服务器（实验性质）

注意：此项目处于实验阶段，旨在探索使用模型上下文协议（MCP）作为Nylas API集成的指南。它并非官方发布，仅用于学习和实验用途。

该项目实现了一个基于Nylas API的模型上下文协议（MCP）服务器。它为开发人员提供了资源、工具和提示，帮助他们了解并集成与Nylas API相关的电子邮件、日历和联系人功能。

什么是MCP？

模型上下文协议（MCP）是一种整合数据、工具和提示到人工智能应用的标准。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服务器

使用标准输入输出（直接与MCP客户端集成）

npm start

使用HTTP和SSE（远程连接）

MCP_MODE=http npm start

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

MCP_MODE=http PORT=8080 npm start

与MCP客户端一起使用

Claude Desktop

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

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

5. 给它命名（例如，“Nylas API”）
6. 添加完成后，您可以在Claude对话中使用所有Nylas API资源、工具和提示

Cursor

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

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

资源

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

• 通用文档：Nylas API功能概述
• 身份验证指南：如何与Nylas API进行身份验证
• API端点：电子邮件、日历和联系人相关端点的文档
• 代码示例：使用不同编程语言实现Nylas API操作的示例

项目结构

项目的根目录包含以下主要文件和文件夹：

• index.js：主应用程序入口点
• package.json：项目依赖项和脚本的配置
• public/：静态资源，如HTML、CSS和JavaScript文件
• src/：源代码文件，包括服务器逻辑和路由处理

安装与运行

克隆仓库

git clone [仓库链接]
cd nylas-api-mcp

安装依赖项

npm install

构建项目

npm run build

启动服务器

开发模式

npm start

生产模式

npm run start:prod

配置选项

• PORT：指定服务器运行的端口，默认为3000
• NODE_ENV：设置环境模式，可以是development或production

示例使用

发送邮件

请求方法

POST /api/send-email

请求体

{
  "to": "recipient@example.com",
  "subject": "Test Email",
  "text": "This is a test email."
}

获取日历事件

请求方法

GET /api/calendar/events

贡献指南

1. 叉仓项目到自己的仓库
2. 创建功能分支并提交更改
3. 提交代码并创建拉取请求

许可证

MIT