Google Calendar MCP Server (google-calendar-mcp-server)

谷歌日历MCP服务器

日语学习README在这里

本文档介绍了设置环境以使用Google日历API作为MCP服务器搜索日历内容的步骤。

先决条件

• 紫外线 必须安装。
• 一个谷歌账号。

步骤

1.创建谷歌云项目

在Google云控制台中或通过以下链接启用Google日历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. 打开终端或命令提示符。

1. 导航到您的项目目录。

1. 设置虚拟环境并下载所需的库。

   uv sync

生成 token.json

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

   uv run generate_token.py

1. 浏览器将打开，请求访问您的Google帐户的权限。授予许可。

1. 在认证完成之后 token.json 文件将在您的项目目录中创建。

5.配置 calendar_settings.json

1. 编辑 calendar_settings.json.sample 项目目录中的文件。

例如，按如下方式配置它：

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

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

设置必要的日历ID，然后 重命名 文件到 calendar_settings.json 并保存它。

6.配置MCP

1. 导航到 .vscode 在项目目录中的目录中编辑 mcp.json.sample 文件。

1. 编辑 mcp.json.sample 文件如下：

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

- 替换 ` 使用您的用户名。 - 替换 ` 使用您的项目目录名。

例如，如果您的用户名是 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"
         ]
       }
     }
   }

1. 编辑后， 重命名 文件到 mcp.json 并保存它。

7.配置代理模式

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

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

8.使用MCP

1. 打开副驾驶聊天面板。
2. 例如，输入一个聊天，如“列出4月8日的活动”
3. 将显示工具执行确认，单击 继续 按钮执行。
4. 首次使用时，浏览器将打开请求访问您的Google帐户的权限。授予许可。
5. 将显示结果。

故障排除

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