🚀 Nylas API MCP 服务器（实验性质）
本项目实现了一个基于Nylas API的模型上下文协议（MCP）服务器，为开发者提供资源、工具和提示，助力其集成Nylas API的电子邮件、日历和联系人功能。不过要注意，此项目处于实验阶段，仅用于学习和实验，并非官方发布。
🚀 快速开始
依赖项要求
- Node.js 18+ 版本
- npm 包管理器
安装步骤
- 克隆此仓库。
- 安装依赖项：
npm install
- 构建项目：
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
- 在标准输入输出模式下启动MCP服务器。
- 在Claude Desktop中，转到设置 > 服务器。
- 点击“添加服务器”。
- 选择“运行本地命令”并输入启动此服务器的命令：
node /path/to/nylas-api-mcp/dist/index.js
- 给它命名（例如，“Nylas API”）。
- 添加完成后，您可以在Claude对话中使用所有Nylas API资源、工具和提示。
Cursor
- 在标准输入输出模式下启动MCP服务器。
- 在Cursor中添加一个新的MCP服务器设置。
- 配置它以使用以下命令：
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。
贡献指南
- 叉仓项目到自己的仓库。
- 创建功能分支并提交更改。
- 提交代码并创建拉取请求。
🔧 技术细节
本项目基于Nylas API实现了模型上下文协议（MCP）服务器。MCP作为一种整合数据、工具和提示到人工智能应用的标准，使得该服务器能够向兼容的AI应用程序暴露资源、工具和提示。服务器通过Node.js和npm进行管理和运行，提供了多种功能和资源，方便开发者进行Nylas API的集成开发。
📄 许可证
本项目采用MIT许可证。
⚠️ 重要提示
此项目处于实验阶段，旨在探索使用模型上下文协议（MCP）作为Nylas API集成的指南。它并非官方发布，仅用于学习和实验用途。