🚀 Google日历MCP服务器文档（中文版）

本项目是一个Google日历MCP（机器可读数据接口）服务器，它实现了Google日历与[假设是Claude Desktop]平台之间的集成。该服务器具备自动认证功能，用户能借助自然语言指令与Google日历进行交互。

✨ 主要特性

• 创建日历事件：可通过指定时间、地点和描述信息来安排新会议。
• 查询日历事件：能检索特定时间段内的所有或部分日历条目。
• 更新日历事件：允许修改现有事件的详细信息，如标题、时间和位置。
• 删除日历事件：提供删除指定日历事件的功能。

📦 安装指南

环境准备

1. 下载并安装Node.js（推荐使用版本16或更高）。
2. 安装npm包管理工具。
3. 克隆此项目仓库到本地开发环境中。

认证步骤

1. 在Google Cloud Console中创建一个新的项目。
2. 启用日历API和OAuth 2.0客户端认证功能。
3. 创建OAuth 2.0客户端ID，并下载gcp-oauth.keys.json配置文件。
4. 将获取到的私钥文件命名为gcp-oauth.keys.json，并放置在项目的根目录下或当前工作目录中。

💻 使用示例

基础用法

创建日历事件

{
  "summary": "团队会议",
  "start": {
    "dateTime": "2024-01-20T10:00:00Z"
  },
  "end": {
    "dateTime": "2024-01-20T11:00:00Z"
  },
  "description": "每周一次的团队同步会议",
  "location": "A会议室"
}

查询日历事件

{
  "timeMin": "2024-01-01T00:00:00Z",
  "timeMax": "2024-12-31T23:59:59Z",
  "maxResults": 10,
  "orderBy": "startTime"
}

更新日历事件

{
  "eventId": "event123",
  "summary": "更新后的会议主题",
  "start": {
    "dateTime": "2024-01-20T11:00:00Z"
  },
  "end": {
    "dateTime": "2024-01-20T12:00:00Z"
  }
}

删除日历事件

{
  "eventId": "event123"
}

📚 详细文档

安全须知

• 凭证存储：认证信息将安全地保存在本地环境变量~/.calendar-mcp/中。
• 离线访问模式：服务器使用离线访问令牌以保持持久认证状态。
• 凭证管理：请勿分享或提交到版本控制系统。
• 定期审查：建议定期检查并撤销不再使用的Google账户权限。

故障排查

1. 找不到OAuth密钥文件
   • 确保gcp-oauth.keys.json存在于当前工作目录或~/.calendar-mcp/中。
   • 检查文件访问权限设置是否正确。
2. 凭证格式无效
   • 确认密钥文件包含有效的web或installed类型配置。
   • 如果需要重新生成，可以参考Google Cloud Console的文档说明。
3. 端口被占用
   • 检查当前系统进程，确认是否有其他程序占用了目标端口。
   • 可以尝试使用不同的端口号运行服务器。

📄 许可证

• 项目作者：[假设是Claude Desktop开发团队]
• 许可证类型：ISC许可证
• 任何个人或组织都可以自由使用、修改和分发此软件，但需遵守相关法律条款。

此文档介绍了Google日历MCP服务器的基本功能、安装方法及使用指南。如需进一步支持，请参考相关技术文档或联系项目维护人员。