谷歌日历 MCP 服务器

通过 Claude Desktop 使用模型上下文协议（MCP）与您的 Google Calendar 进行交互。

这是一个基于 TypeScript 的 MCP 服务器，实现 Google 日历集成。它演示核心 MCP 概念的同时提供：

• 通过 MCP URI 访问日历事件
• 创建和修改事件的工具
• 自动生成日历洞察的提示

功能

资源

• 通过 MCP URI 访问日历事件
• 每个事件包含标题、时间和描述以及与会者
• 结构化的事件数据，带有正确的 MIME 类型

工具

• create_event - 创建新的日历事件
  • 接收标题、时间和其他事件详细信息作为参数
  • 直接接口 Google 日历 API
• list_events - 查看即将进行的日历事件
• [添加您实现的其他工具]

提示

• analyze_schedule - 生成日历洞察
  • 包含即将发生的事件作为嵌入资源
  • 返回结构化的提示以供 LLM 分析
• [添加您实现的其他提示]

先决条件

• Node.js (v14 或更高版本)
• 启用 Google Calendar API 的 Google Cloud 项目
• OAuth 2.0 客户端凭证

开发

按照 devbox.sh 中的说明安装 devbox：

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

在项目目录中初始化 devbox：

devbox init

启动 devbox shell：

devbox shell

安装依赖项：

npm install

构建服务器：

npm run build

带有自动重建的开发：

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。