谷歌日历自动授权MCP服务器

项目概述

这是一个用于自动化管理Google日历的MCP（机器学习控制协议）服务器，支持创建、更新、删除和查询日历事件等功能。该服务器集成了自动授权功能，简化了与Google Calendar API的交互流程。

核心特性

• 自动化授权：用户通过简单的身份验证即可获得长期访问令牌，无需手动处理OAuth流程。
• 高可用性：采用高效的API设计和可靠的网络通信机制，确保服务稳定运行。
• 可扩展性：支持多线程处理，能够同时处理多个用户的日历请求。

安装与配置

安装依赖

1. 确保系统已安装Python 3.6或更高版本。
2. 安装必要的Python库：

   pip install google-api-python-client oauth2client flask
   

配置步骤

1. 下载项目代码并解压到指定目录。
2. 配置环境变量：
   • 设置GC_CREDENTIALS为包含OAuth凭证文件的路径。
   • 设置GC_PROJECT_ID为目标项目的Google Cloud项目ID。

功能模块

事件管理

• 创建事件：支持通过JSON格式传递详细信息，包括标题、时间、地点等。

  {
    "summary": "会议",
    "start_time": "2024-05-15T14:00:00",
    "end_time": "2024-05-15T16:00:00"
  }
  

• 更新事件：通过事件ID指定要修改的条目，并提供新的详细信息。
• 删除事件：使用事件ID直接从日历中移除特定条目。

日历同步

• 批量导入：支持一次性导入多个事件，提升数据迁移效率。
• 增量更新：仅同步变更的部分，减少网络传输量和服务器负载。

安全机制

• 凭证加密：所有OAuth凭证均经过AES加密处理，确保存储安全。
• 访问控制：基于角色的权限管理，防止未授权操作。
• 审计日志：记录所有API调用历史，便于后续追踪和分析。

示例使用场景

# 创建新事件
curl -X POST \
     http://localhost:5000/api/events \
     -H "Content-Type: application/json" \
     -d '{"summary":"项目会议","start_time":"2024-05-16T10:00:00","end_time":"2024-05-16T11:30:00"}'

# 查询特定事件
curl -X GET \
     http://localhost:5000/api/events/abc123xyz456

常见问题解答

1. 如何处理授权过期？

   • 服务器会自动检测令牌有效期，到期后自动刷新。

2. 能否支持多个日历账户？

   • 是的，每个用户都有独立的日历存储空间，确保数据隔离。

3. 如何提高查询效率？

   • 使用过滤参数（如时间范围、事件标签）可以显著提升查询速度。

项目文档

• 详细接口定义请参考API文档。
• 示例代码和使用教程可访问Wiki页面。

贡献与支持

欢迎提交Pull Request或报告问题。如需商业支持，请联系项目维护者。

感谢您选择我们的Google日历自动授权MCP服务器，期待您的反馈和建议！