Google Calendar MCP Server - คู่มือการติดตั้งและการใช้งาน

基本能力

产品定位

Google Calendar MCP Server 是一个用于管理 Google 日历的服务，通过 MCP 协议提供标准化的接口，方便与 Claude 和其他 AI 系统集成。

核心功能

• 无缝连接 Google Calendar API
• 支持异步操作以提高性能
• 使用 OAuth 2.0 认证并自动刷新令牌
• 全面的错误处理和日志记录
• 简化的 MCP 接口，便于与 AI 系统集成

适用场景

• 个人日程管理
• 团队会议安排
• 自动化日历操作
• 与 AI 系统集成的日历服务

工具列表

常见问题解答

1. 认证问题
2. 确保 credentials.json 和 token.json 文件位于 credentials/ 文件夹中

3. 删除 token.json 并使用 create_token.py 重新生成

4. 时区问题

5. 确保已安装时区库：pip install pytz tzdata

6. 日志检查

7. 查看日志文件以获取更多错误信息：cat logs/calendar_service.log

使用教程

使用依赖

• Python 3.9 或更高版本
• 互联网连接
• 已启用 Google Calendar API 的 Google Cloud Console 项目

安装教程

1. 克隆项目 bash git clone https://github.com/yourusername/GCalendar.git cd GCalendar

2. 创建虚拟环境（推荐） ```bash python -m venv gcalendar_venv

# Windows gcalendar_venv\Scripts\activate

# macOS/Linux source gcalendar_venv/bin/activate ```

1. 安装必要的包 bash pip install -r requirements.txt

2. 准备必要的文件夹 bash mkdir -p credentials logs

认证设置

1. 创建 Google Cloud Console 项目
2. 访问 Google Cloud Console
3. 创建新项目
4. 启用 Google Calendar API
5. 创建 OAuth 2.0 Client ID

6. 下载 credentials.json 到 credentials/ 文件夹

7. 创建令牌 bash python src/create_token.py

8. 按照浏览器中的步骤授权访问
9. 令牌将保存在 credentials/ 文件夹中，名为 token.json

调试方式

1. 手动启动服务器 bash python src/mcp_server.py

2. 检查日志 bash cat logs/calendar_service.log

许可证

该项目遵循 MIT 开源许可条款。