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集成的指南。它並非官方發佈，僅用於學習和實驗用途。