G2n MCP Gcal Sse

🚀 G2N MCP 谷歌日曆 SSE 服務器

G2N MCP 谷歌日曆 SSE 服務器基於 Model Context Protocol (MCP) 實現，藉助 Server-Sent Events (SSE) 達成與谷歌日曆的集成。它把谷歌日曆功能作為工具提供給 AI 模型以及 Cursor、Claude 和 n8n 等應用程序，方便它們與谷歌日曆進行交互。

🌍 此 README 支持多種語言：

• 🇺🇸 English
• 🇧🇷 Portuguese

🚀 快速開始

先決條件

• 安裝 Docker 和 Docker Compose
• 谷歌雲項目中啟用了日曆 API
• 谷歌 OAuth 2.0 客戶端 ID 和客戶端密鑰

環境變量

服務器使用的環境變量如下：

PORT=3001                                # 服務器端口（默認：3001）
PUBLIC_URL=https://your-domain.com       # 公共 URL，用於 OAuth 回調
GOOGLE_CLIENT_ID=${GOOGLE_CLIENT_ID}     # 谷歌 OAuth 客戶端 ID
GOOGLE_CLIENT_SECRET=${GOOGLE_CLIENT_SECRET} # 谷歌 OAuth 客戶端密鑰
OAUTH_REDIRECT_PATH=/oauth/callback      # OAuth 回調路徑（默認：/oauth/callback）

⚠️ 重要提示

• 使用 Traefik 時，請確保配置其指向 PORT 環境變量指定的端口。
• 這對於成功接收谷歌刷新令牌至關重要。
• PUBLIC_URL 必須可以上網，以使 OAuth 回調正常工作。

支持的語言

默認支持兩種語言：

• 中文 (zh-CN)
• 英文 (en-US)

✨ 主要特性

此服務器為谷歌日曆管理提供了以下 MCP 工具：

• list-calendars：列出所有可用的日曆
• get-calendar：獲取特定日曆的詳細信息
• list-events：按過濾選項從日曆中列出事件
• get-event：獲取特定事件的詳細信息
• create-event：創建新的日曆事件
• update-event：更新現有日曆事件
• delete-event：刪除日曆事件
• list-colors：列出事件和日曆可用的顏色

v1.1.0 新增功能

• 全面的日誌系統，支持配置日誌級別
• 請求/響應日誌中間件以實現更好的監控
• SSE 心跳機制以保持連接穩定
• 增強的錯誤處理和調試能力
• 改進的 Docker 配置，帶有適當的數據目錄權限
• 增強的 OAuth 流程和更優的令牌管理
• 代碼重構以提高維護性

v1.0.1 新增功能

• 第一個穩定版本發佈
• 生產就緒，支持 Docker 和 Docker Swarm 部署
• 改進的環境變量配置
• 提升不同部署場景下的連接 URL 性能
• 更好的 n8n 集成文檔
• Traefik 配置指南
• 多平臺 Docker 映像（amd64、arm64、arm/v7）

📦 安裝指南

安裝步驟

1. 克隆倉庫

git clone https://github.com/your-repository.git
cd G2N-MCP-GoogleCalendar-SSE-Server

2. 安裝依賴

npm install

3. 配置環境變量

• 創建 .env 文件並添加以下內容：

PORT=3001
PUBLIC_URL=https://your-domain.com
GOOGLE_CLIENT_ID=你的谷歌客戶端ID
GOOGLE_CLIENT_SECRET=你的谷歌客戶端密鑰

4. 啟動服務器

npm start

💻 使用示例

基礎用法

啟動服務器後，可以通過以下端點訪問服務：

• GET /api/list-calendars：列出所有日曆
• GET /api/get-calendar?calendarId=your_calendar_id：獲取特定日曆的詳細信息
• GET /api/list-events?calendarId=your_calendar_id：按過濾選項列出事件

示例請求

curl http://localhost:3001/api/list-calendars

📄 許可證

此項目根據 MIT License 發佈，詳情請參見 LICENSE 文件。

關於 G2NTech

此項目由 Gabriel Augusto 在 G2NTech 開發和維護。

支持項目 💜

如果你發現該項目對你有幫助，請考慮通過PIX支持我們：

• PIX Key: gabriel@g2ngroup.com