G2N MCP 谷歌日历 SSE 服务器

🌍 此 README 支持多种语言：

• 🇺🇸 English
• 🇧🇷 Portuguese

概述

G2N MCP 谷歌日历 SSE 服务器是一个基于 Model Context Protocol (MCP) 的服务器实现，通过 Server-Sent Events (SSE) 提供与谷歌日历的集成。此服务器将谷歌日历功能作为工具提供，可供 AI 模型和 Cursor、Claude 和 n8n 等应用程序使用，以与谷歌日历交互。

该服务器基于最新的 MCP SDK 版本构建，提供了强大的谷歌日历服务与 MCP 兼容模型之间的整合。

功能

此服务器为谷歌日历管理提供了以下 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）

入门指南

erequisites 先决条件

• 安装 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 回调正常工作

支持的Lnguage 语言支持

默认支持两种语言：

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

安装指南

安装步骤

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