Google Calendar MCP Server

🚀 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中的設置。