Py MCP Gcalendar

🚀 Google Calendar MCP 服务器 - Python 安装指南

本项目是一个提供对 Google 日历 API 访问的模型上下文协议（Model Context Protocol）服务器，支持异步操作。通过标准化接口，实现了高效的日历管理。

✨ 主要特性

API 工具

• 列表：可查询过去两年到未来一年的日历事件。
• 创建活动：能够创建新的日历条目。
• 删除重复项：可移除重复的事件。
• 删除活动：可以删除特定的日历事件。

核心资源

• 令牌管理系统（credentials/*.json）
  • 具备 OAuth 2.0 身份验证流程。
  • 支持自动令牌刷新处理。
  • 可进行运行时令牌发现。
• 记录系统（logs/*.log）
  • 会记录操作（含时间戳）。
  • 可进行错误跟踪和调试。
  • 能收集性能指标。

📦 安装指南

先决条件

# 安装所需的 Python 包
pip install -r requirements.txt

依赖项：

google-auth-oauthlib==1.0.0
google-auth-httplib2==0.1.0
google-api-python-client==2.108.0
aiohttp==3.8.5
asyncio==3.4.3

初始设置

# 克隆仓库
git clone https://github.com/yourusername/GCalendar.git
cd GCalendar

# 创建所需目录
mkdir -p credentials logs

身份验证设置

1. 在 Google Cloud Console 中创建项目。
2. 启用 Google 日历 API。
3. 将 credentials.json 下载到 credentials/ 目录。
4. 运行 create_token.py：

python src/create_token.py

📚 详细文档

服务器配置

在 claude_desktop_config.json 中添加：

{
  "mcpServers": {
    "gcalendar": {
      "command": "YOUR_CONDA_PATH/envs/mcp-gcalendar/bin/python",
      "args": [
        "YOUR_PATH/GCalendar/src/mcp_server.py"
      ]
    }
  }
}

路径配置

替换占位符：

• YOUR_CONDA_PATH 选项：
  • M1/M2 Mac: /opt/homebrew/Caskroom/miniforge/base
  • Miniconda: ~/miniconda3 或 /opt/miniconda3
• YOUR_PATH：完整的仓库克隆路径

错误处理

• 自动令牌刷新（在过期时）。
• 60 秒操作超时。
• 全面错误记录。
• 瞬态错误自动重试。

项目结构

GCalendar/
├── credentials/
│   ├── credentials.json   # 来自 Google Cloud Console 的文件
│   └── token.json        # 由 create_token.py 生成的文件
├── logs/
│   └── calendar_service.log
├── src/
│   ├── calendar_service.py   # 核心日历操作
│   ├── create_token.py      # 令牌生成
│   ├── list_past_events.py  # 活动列表工具
│   ├── mcp_client.py        # MCP 客户端实现
│   ├── mcp_server.py        # 主服务器实现
│   └── renew_token.py       # 令牌更新工具
├── requirements.txt
└── README.md

系统要求

• Python 3.9 或更高版本。
• Google 日历 API 已启用。
• 有效的 OAuth 2.0 凭据。
• 上网连接。
• 时区设置为亚洲/曼谷。

🔧 技术细节

服务器配置

在 claude_desktop_config.json 中添加服务器配置信息，以确保服务器能够正确启动和运行。

路径配置

根据不同的操作系统和环境，替换相应的占位符，保证路径的正确性。

错误处理

通过自动令牌刷新、操作超时设置、全面错误记录和瞬态错误自动重试等机制，提高系统的稳定性和可靠性。

📄 许可证

该项目采用 MIT 许可证。有关详细信息，请参阅 LICENSE 文件。