Google Calendar MCP 服务器

日本語のREADMEはこちら

本文档介绍了设置环境以使用 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. 配置代理模式

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

1. 打开 Visual Studio Code 并导航到扩展视图。
2. 搜索并安装“GitHub Copilot Chat”扩展。
3. 安装完成后，“Copilot Chat”图标将出现在侧边栏中。 单击它以打开 Copilot Chat 面板。
4. 单击 Copilot Chat 面板顶部的齿轮图标以打开设置。
5. 在设置中启用“代理模式”。

8. 使用 MCP

1. 打开 Copilot Chat 面板。
2. 例如，输入诸如“列出 4 月 8 日的事件”之类的聊天内容。
3. 将显示工具执行确认，单击继续按钮以执行。
4. 首次使用时，将打开一个浏览器，请求允许访问您的 Google 帐户。 授予权限。
5. 将显示结果。

故障排除

• 如果发生错误：检查错误消息，如有必要，重新安装依赖项或检查 Google Cloud Console 中的设置。