使用说明

项目简介

本项目实现了一个 MCP 服务器，旨在使 AI 助手能够与 Google Calendar 进行交互。通过此服务器，AI 助手可以调用工具来创建和管理用户的 Google 日历事件，例如创建新的会议或预约。

主要功能点

• 创建日历事件: 允许 AI 助手创建包含标题、描述、开始时间和结束时间的 Google 日历事件。
• 支持添加参与者: 可以为日历事件添加参与者，方便邀请他人参加会议。
• OAuth2 认证: 使用安全的 OAuth2 认证方式访问 Google Calendar API，保障用户数据安全。
• MCP 协议实现: 遵循 Model Context Protocol 标准，可以与任何兼容 MCP 协议的 AI 客户端进行通信。

安装步骤

1. 克隆仓库: 首先，将代码仓库克隆到本地：

   git clone [https://github.com/markelaugust74/mcp-google-calendar.git]
   cd mcp-google-calendar
   

2. 安装依赖: 安装项目所需的 Node.js 依赖包：

   npm install
   

3. 配置环境变量:

   • 复制 '.env.example' 文件并重命名为 '.env'。
   • 在 '.env' 文件中，填入你的 Google OAuth2 客户端 ID (GOOGLE_CLIENT_ID) 和客户端密钥 (GOOGLE_CLIENT_SECRET)。 这些凭据需要在 Google Cloud Console 中创建 Google Calendar API 项目并启用 API 后获得。

4. 获取 Refresh Token: 运行以下命令获取 Google OAuth2 的 Refresh Token：

   npm run auth
   

   按照终端提示访问授权链接，授权后复制授权码到终端，脚本将输出 Refresh Token。

5. 更新 Refresh Token: 打开 'index.js' 文件，找到 'oauth2Client.setCredentials' 部分，将 'refresh_token: "YOUR_REFRESH_TOKEN"' 替换为你上一步获取的 Refresh Token。

服务器配置

MCP 客户端需要以下配置信息才能连接到此 MCP 服务器：

{
  "serverName": "mcp_calendar",
  "command": "node",
  "args": ["index.js"]
}

配置参数说明:

• 'serverName': 服务器名称，这里设置为 "mcp_calendar"。
• 'command': 启动服务器的命令，这里使用 'node' 运行 Node.js 程序。
• 'args': 启动命令的参数，这里指定运行 'index.js' 文件。

基本使用方法

1. 启动服务器: 在项目根目录下，运行以下命令启动 MCP 服务器：

   npm start
   

   服务器将通过 stdio (标准输入输出) 与 MCP 客户端进行通信。

2. 配置 MCP 客户端: 在你的 MCP 客户端中，根据上述“服务器配置”信息配置连接到此服务器。

3. 使用 AI 助手: 配置完成后，你的 AI 助手就可以通过 MCP 协议调用 'create_event' 工具，指示服务器在 Google Calendar 中创建日历事件。