Google Calendar MCP 服务器

通过模型上下文协议 (MCP) 使用 Claude Desktop 与您的 Google Calendar 互动。

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

• 通过 MCP URI 进行日历事件管理
• 用于创建和修改事件的工具
• 用于生成日历见解的提示

功能

资源

• 通过 MCP URI 访问日历事件
• 每个事件都有标题、时间、描述和参与者
• 具有适当 MIME 类型的结构化事件数据

工具

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

提示

• analyze_schedule - 生成关于您的日历的见解
  • 包括即将到来的事件作为嵌入式资源
  • 返回用于 LLM 分析的结构化提示
• [添加您已实现的其他提示]

前提条件

• Node.js (v14 或更高版本)
• 启用了 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 Calendar API
   • 创建 OAuth 2.0 凭据（桌面应用程序类型）
   • 下载客户端密钥 JSON 文件
   • 将其重命名为 .client_secret.json 并将其放置在项目根目录中

2. 初始身份验证：

   • 首次运行服务器时，它将提供一个身份验证 URL
   • 在您的浏览器中访问该 URL
   • 授予请求的权限
   • 复制提供的授权码
   • 将代码粘贴回 CLI 提示符

调试

由于 MCP 服务器通过 stdio 进行通信，因此调试可能具有挑战性。 我们建议使用 MCP Inspector，它作为包脚本提供：

npm run inspector

Inspector 将提供一个 URL 以访问浏览器中的调试工具。