谷歌日历模型上下文协议服务器（Google Calendar MCP Server）

项目概述

这是一个用于与谷歌日历交互的服务器端项目，支持创建、读取、更新和删除日历事件，以及查找空闲时间段。使用Node.js编写，并通过OAuth 2.0进行身份验证。

功能

• 创建事件：添加新的日历事件。
• 读取事件：获取指定时间段内的所有事件。
• 更新事件：修改现有事件的详细信息。
• 删除事件：移除特定的日历事件。
• 查找空闲时间：在指定时间段内查找可用时间窗口。

安装与配置

1. 准备工作

• 下载项目文件并解压到目标目录。
• 确保已安装Node.js（建议版本8.0或更高）和npm。

2. 安装依赖项

在项目根目录中运行以下命令：

npm install

3. 配置环境变量

复制.env.example文件为.env，并根据实际情况填写以下内容：

CLIENT_ID=你的客户端ID
CLIENT_SECRET=你的客户端密码
REDIRECT_URI=重定向链接地址（例如：http://localhost:3000/oauth2callback）
REFRESH_TOKEN=获取的刷新令牌

使用方法

1. 作为HTTP/SSE服务器

• 在项目根目录中运行以下命令启动服务：

npm run start:http

• 默认监听地址为http://localhost:3334。

2. 作为CLI工具

• 运行以下命令以控制台模式启动：

npm run start:stdio

示例代码

创建事件

{
  "summary": "会议",
  "description": "重要项目讨论会",
  "start": {
    "dateTime": "2023-10-10T09:00:00+08:00"
  },
  "end": {
    "dateTime": "2023-10-10T11:00:00+08:00"
  }
}

获取刷新令牌

步骤说明

1. 运行以下脚本以启动授权流程：

const { google } = require('googleapis');
const http = require('http');
const url = require('url');

// 替换为你的实际信息
const CLIENT_ID = '你的客户端ID';
const CLIENT_SECRET = '你的客户端密码';
const REDIRECT_URI = 'http://localhost:3000/oauth2callback';

const oauth2Client = new google.auth.OAuth2(
  CLIENT_ID,
  CLIENT_SECRET,
  REDIRECT_URI
);

const scopes = [
  'https://www.googleapis.com/auth/calendar',
  'https://www.googleapis.com/auth/calendar.events'
];

function getRefreshToken() {
  const server = http.createServer(async (req, res) => {
    const queryParams = url.parse(req.url, true).query;
    
    if (queryParams.code) {
      try {
        const { tokens } = await oauth2Client.getToken(queryParams.code);
        console.log('刷新令牌:', tokens.refresh_token);
        res.end('身份验证成功！你可以关闭此窗口。');
        server.close();
      } catch (error) {
        console.error('获取令牌失败:', error);
        res.end('身份验证失败！');
      }
    }
  }).listen(3000, () => {
    const authUrl = oauth2Client.generateAuthUrl({
      access_type: 'offline',
      scope: scopes,
      prompt: 'consent'
    });

    console.log('在浏览器中打开以下链接:');
    console.log(authUrl);
  });
}

getRefreshToken();

2. 根据脚本输出的URL，在浏览器中访问并按照提示完成授权流程。
3. 授权完成后，控制台将显示新的刷新令牌。

开发与调试

npm run dev

常见问题解决

• 认证错误：检查客户端ID、密码和重定向URI是否正确配置。
• 服务器启动失败：确保端口未被占用或权限设置正确。

项目许可

本项目的使用遵循ISC协议。