使用说明

项目简介

Calendar Tools MCP Server 是一个基于 Model Context Protocol (MCP) 构建的后端应用，旨在为大型语言模型 (LLM) 提供与 Google 日历交互的能力。通过此服务器，LLM 可以使用预定义的工具来创建、列出、更新和删除您的 Google 日历中的事件。

主要功能点

创建日历事件：允许 LLM 创建新的 Google 日历事件，包括事件标题、描述、开始时间和结束时间以及参与者。
列出日历事件：允许 LLM 查询并列出 Google 日历中的事件，可以根据时间范围和最大结果数进行过滤。
更新日历事件：允许 LLM 修改现有 Google 日历事件的详细信息，如标题、描述、开始时间、结束时间和参与者。
删除日历事件：允许 LLM 删除指定的 Google 日历事件。

安装步骤

确保已安装 Node.js 和 npm：请先确保您的系统中已安装 Node.js 和 npm (Node Package Manager)。

全局安装 MCP 服务器：打开终端或命令提示符，运行以下命令全局安装此 MCP 服务器：

npm install -g @cablate/mcp-google-calendar

服务器配置

要将此 MCP 服务器与 MCP 客户端（如 Dive Desktop）配合使用，您需要在客户端中配置服务器连接信息。以下是 Dive Desktop 的服务器配置示例（JSON 格式）：

{
  "mcpServers": {
    "calendar": {
      "command": "npx",
      "args": ["-y", "@cablate/mcp-google-calendar"],
      "env": {
        "GOOGLE_CALENDAR_ID": "your_calendar_id",
        "GOOGLE_TIME_ZONE": "your_time_zone",
        "GOOGLE_CREDENTIALS_PATH": "path/to/your/credentials.json"
      },
      "enabled": true
    }
  }
}

配置参数说明：

'server name': 'calendar' (服务器名称，您可以自定义)
'command': 'npx' (Node Package Execute，用于执行 npm 包，假定 npm 已安装并在 PATH 环境变量中)
'args': '["-y", "@cablate/mcp-google-calendar"]' (执行已全局安装的 '@cablate/mcp-google-calendar' 包)
'env': 环境变量配置，用于服务器连接 Google Calendar API：
- 'GOOGLE_CALENDAR_ID': 您的 Google 日历 ID。通常是您的电子邮件地址，或者可以使用 "primary" 代表主日历。
- 'GOOGLE_TIME_ZONE': 您希望使用的时区，例如 '"Asia/Taipei"' 或 '"America/Los_Angeles"'。时区列表请参考 IANA Time Zone Database。
- 'GOOGLE_CREDENTIALS_PATH': Google 服务帐户凭据 JSON 文件的路径。您需要按照仓库 README 中的 “Google Service Account and Credentials” 章节的指引创建并下载此文件，并将其路径配置在此处。
'enabled': 'true' (启用此服务器)

请务必将 'your_calendar_id'、'your_time_zone' 和 'path/to/your/credentials.json' 替换为您实际的值。 凭据文件 'credentials.json' 的创建步骤请参考仓库的 README.md 文档。

基本使用方法

配置并启用 MCP 服务器后，您可以在 MCP 客户端中指示 LLM 使用提供的工具。例如，要创建一个日历事件，您可以指示 LLM 使用 "create_event" 工具，并提供必要的参数，如事件标题 (summary)、开始时间 (startTime) 和结束时间 (endTime) 等。LLM 将通过 MCP 协议与此服务器通信，从而在您的 Google 日历中执行相应的操作。

关键词