G2n MCP Gcal SSE

G2N MCP谷歌日历SSE服务器

🌎 此README有多种语言版本：

• 🇺🇸 英语
• 🇧🇷 葡萄牙语

概述

G2N MCP谷歌日历SSE服务器是一种模型上下文协议（MCP）服务器实现，通过服务器发送事件（SSE）提供谷歌日历集成。该服务器将Google日历功能作为工具公开，可供Cursor、Claude和n8n等AI模型和应用程序用于与Google日历交互。

该服务器采用最新的MCP SDK版本构建，在MCP兼容模型和Google日历服务之间提供了强大的集成。

特性

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

入门指南

先决条件

• 已安装Docker和Docker Compose
• 启用日历API的谷歌云项目
• OAuth 2.0客户端ID和客户端密钥

环境变量

服务器使用以下环境变量：

PORT=3001                                # Server port (default: 3001)
PUBLIC_URL=https://your-domain.com       # Public URL for OAuth callbacks
GOOGLE_CLIENT_ID=${GOOGLE_CLIENT_ID}     # Google OAuth Client ID
GOOGLE_CLIENT_SECRET=${GOOGLE_CLIENT_SECRET} # Google OAuth Client Secret
OAUTH_REDIRECT_PATH=/oauth/callback      # OAuth callback path (default: /oauth/callback)

重要提示：

• 使用Traefik时，请确保将其配置为指向 PORT 环境变量
• 这对于成功接收Google刷新令牌至关重要
• 这 PUBLIC_URL 必须可访问互联网，OAuth回调才能工作

身份验证流程

1. 使用Docker或直接启动服务器
2. 导航到 /auth 浏览器中的端点
3. 使用您的Google帐户授予应用程序权限
4. 授权后，服务器将存储刷新令牌以供连续访问
5. 服务器将在需要时自动刷新令牌

要撤销访问权限，请使用 /revoke 端点：

curl -X POST https://your-domain.com/revoke

与MCP兼容的应用程序一起使用

连接URL

根据您的部署场景，使用适当的URL格式：

1. Docker Swarm/n8n内部访问：

   http://[stack-service-name]:3001/sse

示例：如果您的服务被命名 g2n-mcp-gcal-sse 在堆栈中，使用：

   http://g2n-mcp-gcal-sse:3001/sse

1. 外部访问（Cursor、Claude等）：

   https://your-domain.com/sse

1. 地方发展：

   http://localhost:3001/sse

光标AI

您可以通过在设置中配置MCP连接，将此服务器与Cursor AI一起使用：

1. 打开光标设置
2. 使用您的公共域配置MCP服务器URL：

   https://your-domain.com/sse

1. 通过AI命令开始使用Google日历功能

克劳德桌面

对于Claude Desktop：

1. 导航到“设置”>“MCP”
2. 使用您的公共URL添加新的MCP连接：

   https://your-domain.com/sse

1. 通过对话访问谷歌日历功能

n8n

1. 在n8n中，添加一个新的MCP节点
2. 使用内部服务URL配置MCP节点：

   http://[stack-service-name]:3001/sse

1. 在工作流中使用公开的日历工具

许可证

此项目根据MIT许可证获得许可-有关详细信息，请参阅许可证文件。

关于G2NTech

该项目由以下人员开发和维护 加布里埃尔·奥古斯托 在G2NTech。

支持项目💜

如果你觉得这个项目有用，可以考虑通过PIX支持它：

• PIX密钥： gabriel@g2ngroup.com