Google Calendar MCP Server

🚀 Google Calendar MCP服务器

本文档详细说明了使用Google Calendar API搜索日历内容，并将其设置为MCP服务器所需的环境配置步骤，帮助你快速搭建相关环境。

🚀 快速开始

✨ 先决条件

• 必须安装 uv。
• 需要一个Google账户。

📋 配置步骤

1. 创建Google Cloud项目

在Google Cloud Console或以下链接中启用Google Calendar API： 启用API

2. 配置OAuth 2.0同意屏幕

导航到Google Cloud Console菜单中的品牌页，或访问以下链接： 品牌

1. 设置应用程序名称。
2. 设置用户支持电子邮件。
3. 设置开发者联系方式。

3. 配置桌面应用凭证

导航到Google Cloud Console菜单中的客户端页面，或访问以下链接： 客户端

1. 点击创建凭据。
2. 在应用程序类型下选择桌面应用。
3. 在名称字段中为凭证输入一个名称。
4. 点击创建。
5. 下载并保存生成的JSON文件，命名为credentials.json，并将该文件移动到你的工作目录。

4. 配置Python环境

创建虚拟环境

1. 打开终端或命令提示符。
2. 切换到项目目录。
3. 设置虚拟环境并下载所需的库。

uv sync

生成token.json

1. 运行以下命令以生成token.json文件：

uv run generate_token.py

2. 浏览器将打开，请求权限访问你的Google账户。授予权限。
3. 验证完成后，会在项目目录中创建token.json文件。

5. 配置calendar_settings.json

1. 编辑项目目录中的calendar_settings.json.sample文件。 例如，配置如下：

{
  "calendar_ids": {
    "primary": "primary",
    "work": "example_work_schedule_id"
  }
}

• primary：你的Google账户主日历的ID（通常为“primary”）。
• work：工作日历的ID。

设置所需的日历ID，然后将文件重命名为calendar_settings.json并保存。

6. 配置MCP

1. 在项目目录中导航到.vscode目录，并编辑其中的mcp.json.sample文件。
2. 修改mcp.json.sample文件如下：

{
  "servers": {
    "google-calendar-mcp-server": {
      "type": "stdio",
      "command": "/home/<username>/<dir>/.venv/bin/python",
      "args": [
        "/home/<username>/<dir>/google_calendar_mcp_server.py"
      ]
    }
  }
}

• 将<username>替换为你的用户名。
• 将<dir>替换为项目目录名。

例如，如果你的用户名是tatsuya，项目目录名为google-calendar-mcp-server，配置如下：

{
  "servers": {
    "google-calendar-mcp-server": {
      "type": "stdio",
      "command": "/home/tatsuya/google-calendar-mcp-server/.venv/bin/python",
      "args": [
        "/home/tatsuya/google-calendar-mcp-server/google_calendar_mcp_server.py"
      ]
    }
  }
}

3. 修改完成后，将文件重命名为mcp.json并保存。

7. 配置代理模式

按照以下步骤设置GitHub Copilot Chat在Visual Studio Code中的代理模式：

1. 打开Visual Studio Code，并导航到扩展视图。
2. 搜索并安装“GitHub Copilot Chat”扩展。
3. 安装完成后，重启Visual Studio Code。

8. 启动代理

1. 在Visual Studio Code中打开要配置的文件夹。
2. 点击右侧活动栏中的代理图标（一个机器人头像）。
3. 如果是第一次使用，可能会提示你初始化设置。按照提示完成操作。
4. 输入以下命令以启动代理：

npm run dev

5. 代理将在指定端口上运行，默认为localhost:3000。

⚙️ 故障排除

⚠️ 重要提示

如果发生错误，请检查错误信息，并根据需要重新安装依赖项或检查Google Cloud Console中的设置。