Google Calendar MCP Server

🚀 谷歌日曆 MCP 服務器

本項目藉助 Claude Desktop，通過模型上下文協議（MCP）實現與 Google Calendar 的交互。這是一個基於 TypeScript 的 MCP 服務器，專注於 Google 日曆集成。在演示核心 MCP 概念的同時，它具備以下功能：

• 支持通過 MCP URI 訪問日曆事件。
• 提供創建和修改事件的工具。
• 可自動生成日曆洞察提示。

🚀 快速開始

先決條件

• Node.js（v14 或更高版本）
• 啟用 Google Calendar API 的 Google Cloud 項目
• OAuth 2.0 客戶端憑證

開發步驟

1. 按照 devbox.sh 中的說明安裝 devbox：

curl -fsSL https://get.jetpack.io/devbox | bash

2. 在項目目錄中初始化 devbox：

devbox init

3. 啟動 devbox shell：

devbox shell

4. 安裝依賴項：

npm install

5. 構建服務器：

npm run build

6. 帶有自動重建的開發：

npm run watch

安裝步驟

與 Claude Desktop 一起使用時添加服務器配置：

• 在 MacOS 上：~/Library/Application Support/Claude/claude_desktop_config.json
• 在 Windows 上：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "Google Calendar": {
      "command": "/path/to/Google Calendar/build/index.js"
    }
  }
}

首次設置

1. 設置 Google Cloud 憑證：
   • 轉到 Google Cloud Console。
   • 創建新項目或選擇現有項目。
   • 啟用 Google 日曆 API。
   • 創建 OAuth 2.0 憑證（桌面應用程序類型）。
   • 下載客戶端秘密 JSON 文件。
   • 將其重命名為 .client_secret.json 並放在項目根目錄中。
2. 初始身份驗證：
   • 運行服務器時，它會提供一個身份驗證 URL。
   • 在瀏覽器中訪問該 URL。
   • 授予所需的權限。
   • 複製提供的授權代碼。
   • 將代碼粘貼回 CLI 提示符。

調試

由於 MCP 服務器通過 stdio 通信，調試可能具有挑戰性。我們推薦使用 MCP Inspector，它作為包腳本可用：

npm run inspector

Inspector 會提供一個訪問調試工具的瀏覽器 URL。

✨ 主要特性

資源

• 可通過 MCP URI 訪問日曆事件。
• 每個事件包含標題、時間、描述以及與會者信息。
• 具備結構化的事件數據，帶有正確的 MIME 類型。

工具

• create_event - 創建新的日曆事件：
  • 接收標題、時間和其他事件詳細信息作為參數。
  • 直接接口 Google 日曆 API。
• list_events - 查看即將進行的日曆事件。
• [添加您實現的其他工具]

提示

• analyze_schedule - 生成日曆洞察：
  • 包含即將發生的事件作為嵌入資源。
  • 返回結構化的提示以供 LLM 分析。
• [添加您實現的其他提示]