使用说明

项目简介

Google Calendar MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器实现，旨在为大型语言模型 (LLM) 提供访问和操作 Google 日历的能力。通过此服务器，LLM 可以执行如查询日程、创建新的日历事件、以及检查用户或多人的忙闲状态等操作，从而实现智能化的日程管理和会议安排。

主要功能点

查询日历事件：允许 LLM 获取指定日历中的事件列表，可以根据时间范围和最大结果数进行筛选。
列出日历：允许 LLM 获取用户可访问的所有日历列表。
检查忙闲状态：允许 LLM 查询用户或多个用户在特定时间段内的忙闲信息，用于会议安排等场景。
创建日历事件：允许 LLM 在指定日历中创建新的事件，包括事件标题、描述、时间、参与者、提醒等详细信息。

安装步骤

安装 Node.js: 确保你的系统已安装 Node.js v18.0.0 或更高版本。
安装 Claude Desktop: 此 MCP 服务器是为 Claude Desktop 设计的，请确保已安装 Claude Desktop 客户端。
执行初始化命令: 打开终端，导航到你希望安装 MCP 服务器的目录，并运行以下命令：
```
npx mcp-server-google-calendar init
```
此命令将自动配置 Claude Desktop 的配置文件，注册 Google Calendar MCP Server。
配置 Google Cloud 项目和认证: 注意: 'README.md' 中指示需要手动设置 Google Cloud 项目和认证，具体步骤可能需要在 Google Cloud 控制台中创建项目、启用 Google Calendar API、创建 OAuth 2.0 客户端 ID，并将凭据文件 ('credentials.json') 放置在服务器根目录下。详细的认证设置步骤请参考仓库 'README.md' 或项目文档 (如果提供)。
重启 Claude Desktop: 完成安装和配置后，重启 Claude Desktop 客户端使配置生效。

服务器配置 (MCP 客户端配置)

对于 MCP 客户端 (例如 Claude Desktop)，需要配置以下服务器信息以连接到 Google Calendar MCP Server。配置信息通常在客户端的设置或配置文件中进行设置。

{
  "mcpServers": {
    "google_calendar": {
      "command": "npx",
      "args": ["-y", "mcp-server-google-calendar", "run"]
    }
  }
}

配置参数说明:

'"google_calendar"': 服务器名称，在客户端中用于标识和调用此服务器。
'"command": "npx"': 启动服务器的命令，这里使用 'npx' 来运行 npm 包。
'"args": ["-y", "mcp-server-google-calendar", "run"]': 传递给 'npx' 命令的参数。
- '"-y"': (可选) 通常用于 'npm' 或 'npx' 命令，表示自动确认安装包。
- '"mcp-server-google-calendar"': 要执行的 npm 包名称，即此 MCP 服务器的包名。
- '"run"': 运行命令，对应于 'package.json' 中定义的 'run' 脚本 (如果存在，根据 'index.ts' 代码推测，实际运行的是 'index.ts' 文件)。

注意: 请确保 Claude Desktop 客户端能够找到 'npx' 命令，并且当前环境已正确配置 Node.js 环境。

基本使用方法

成功安装和配置后，你可以在 Claude Desktop 中使用自然语言指令来调用 Google Calendar MCP Server 的功能。例如：

在 Claude 中输入 '列出我本周的日程' ， Claude 可能会调用 'get-events' 工具来获取你的日历事件。
在 Claude 中输入 '明天下午3点创建一个名为“会议”的事件'， Claude 可能会调用 'create-event' 工具来创建新的日历事件。
你可以尝试其他类似的自然语言指令，Claude 会根据你的指令和配置的 MCP 服务器能力，自动调用相应的 Google Calendar 工具来完成任务。

请注意: 具体的使用方式和指令格式取决于 Claude Desktop 客户端的实现和自然语言理解能力。上述指令仅为示例，实际使用时请参考 Claude Desktop 的文档或提示。

关键词