Nylas Api MCP

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

本项目实现了一个基于Nylas API的模型上下文协议（MCP）服务器，为开发者提供资源、工具和提示，助力其集成Nylas API的电子邮件、日历和联系人功能。不过要注意，此项目处于实验阶段，仅用于学习和实验，并非官方发布。

🚀 快速开始

依赖项要求

• 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服务器具备以下实用功能：

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

📦 安装指南

克隆仓库

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

安装依赖项

npm install

构建项目

npm run build

启动服务器

开发模式

npm start

生产模式

npm run start:prod

💻 使用示例

基础用法

发送邮件

# 请求方法
POST /api/send-email

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

获取日历事件

# 请求方法
GET /api/calendar/events

📚 详细文档

什么是MCP？

模型上下文协议（MCP）是一种整合数据、工具和提示到人工智能应用的标准。MCP服务器可以向AI应用程序（如Claude Desktop、Cursor等MCP兼容的应用程序）暴露资源、工具和提示。

与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/：源代码文件，包括服务器逻辑和路由处理。

配置选项

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

贡献指南

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

🔧 技术细节

本项目基于Nylas API实现了模型上下文协议（MCP）服务器。MCP作为一种整合数据、工具和提示到人工智能应用的标准，使得该服务器能够向兼容的AI应用程序暴露资源、工具和提示。服务器通过Node.js和npm进行管理和运行，提供了多种功能和资源，方便开发者进行Nylas API的集成开发。

📄 许可证

本项目采用MIT许可证。

⚠️ 重要提示

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