🚀 Google Calendar MCP服务器

本文档详细说明了如何使用Google Calendar API搜索日历内容，并将其配置为MCP服务器，涵盖了所需的环境配置步骤。

🚀 快速开始

✨ 主要特性

本项目借助Google Calendar API，实现日历内容的搜索功能，并可将其配置为MCP服务器，为用户提供便捷的日历管理体验。

📦 安装指南

先决条件

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

步骤

1. 创建Google Cloud项目 在Google Cloud Console或以下链接中启用Google Calendar API： 启用API

2. 配置OAuth 2.0同意屏幕 导航到Google Cloud Console菜单中的品牌页，或访问以下链接： 品牌

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

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。
2. 设置所需的日历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. 配置代理模式

   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 Calendar API来实现日历内容的搜索和管理。通过uv工具来管理Python虚拟环境和依赖项。在配置过程中，需要与Google Cloud Console进行交互，获取必要的凭证和权限，以确保能够正常访问Google Calendar服务。

📄 许可证

文档中未提及相关许可证信息。

故障排除

⚠️ 重要提示

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