Google MCP 远程服务器

摘要

本指南详细介绍了如何使用基于 Cloudflare Workers 的 MCP 服务器实现，该服务器可提供与 Google 各项服务（如 Gmail、日历、Drive 等）交互的功能，并适用于 AI 客户端（例如 Claude 或 Cursor）。文档涵盖了功能概述、部署说明、使用方法以及注意事项。

注意事项

首次使用本服务器时，请确保仔细阅读以下内容：

• 安全性警告：请勿使用他人已部署的实例。始终推荐使用自己的 Google Cloud 项目进行部署。
• 技术细节：本指南假设读者具备一定的技术背景，尤其是与 Cloudflare Workers 和 OAuth 相关的知识。

功能概述

概念介绍

MCP（Model Context Protocol）是一种用于连接 AI 模型和后端服务的协议。通过本服务器，AI 模型可以直接调用 Google 的各项 API 服务，包括但不限于：

• Gmail：发送、接收和管理电子邮件。
• 日历：创建、查看和更新日历事件。
• Drive：上传、下载和管理文件。
• YouTube：搜索视频并获取相关内容。

核心特性

1. 基于 Cloudflare Workers：利用 Cloudflare 的边缘计算能力，提供低延迟和高可用性的服务。
2. OAuth 2.0 支持：通过 Google 的 OAuth 流程实现安全的身份验证。
3. 模块化设计：功能按需扩展，支持灵活的 API 调用。

部署说明

前置条件

1. Google Cloud 项目：

   • 创建一个 Google Cloud 项目。
   • 启用以下 APIs：
     • Gmail API
     • Calendar API
     • Drive API
     • YouTube Data API
   • 创建 OAuth 应用，获取 CLIENT_ID 和 CLIENT_SECRET。

2. Cloudflare 账户：

   • 注册并登录 Cloudflare 账户。
   • 创建一个新的 Workers 项目或选择现有项目。

3. 本地开发环境：

   • 安装 Bun（一个现代的 JavaScript 包管理器）。
   • 安装 Node.js 和 npm（用于运行和调试工具）。

部署步骤

1. 代码仓库克隆：

   git clone https://github.com/your-repository/mcp-server.git
   cd mcp-server
   

2. 安装依赖项：

   bun install
   

3. 配置环境变量：

   • 创建一个 .env 文件，内容如下：

     GOOGLE_OAUTH_CLIENT_ID="your-client-id"
     GOOGLE_OAUTH_CLIENT_SECRET="your-client-secret"
     COOKIE_ENCRYPTION_KEY="your-random-encryption-key"
     CLOUDFLARE_ACCOUNT_ID="your-account-id"
     CLOUDFLARE_ZONE_ID="your-zone-id"
     

4. 部署到 Cloudflare Workers：

   • 登录 Cloudflare 账户。
   • 导航至 Workers 项目控制台。
   • 使用 bun run build 构建项目。
   • 点击“Deploy to Cloudflare”按钮。

使用方法

基本用法

1. 授权访问：

   • 第一次使用时，服务器会显示一个批准对话框。
   • 请按照提示完成 Google 的 OAuth 流程，授予服务器所需的权限。

2. 调用 API：

   • 发送请求至服务器的 /api 端点。
   • 支持以下操作：

     # 发送电子邮件
     POST /api/gmail/send
     

     # 获取日历事件
     GET /api/calendar/events?start=2023-10-01&end=2023-10-31
     

示例

发送电子邮件

POST /api/gmail/send
Content-Type: application/json

{
  "to": " jane.doe@example.com",
  "subject": "Meeting Notes",
  "body": "Here are the notes from our meeting."
}

创建日历事件

POST /api/calendar/events
Content-Type: application/json

{
  "title": "Project Meeting",
  "description": "Discuss Q4 objectives",
  "start": "2023-10-15T14:00:00Z",
  "end": "2023-10-15T16:00:00Z"
}

调试与故障排除

常见问题

1. 授权失败：

   • 确保 OAuth 应用已正确配置。
   • 检查 CLIENT_ID 和 CLIENT_SECRET 是否有效。

2. API 请求错误：

   • 确保目标 Google 服务的 API 已启用。
   • 查看 Cloudflare 的日志以获取更多详细信息。

开发工具

• Bun Dev 模式：

  bun dev
  

  这将启动一个本地服务器，便于调试和测试。

附录

环境变量

以下是项目所需的环境变量及其说明：

工具链

• Bun：一个现代化的包管理器，用于依赖管理和脚本执行。
• Cloudflare CLI：用于与 Cloudflare Workers 交互的命令行工具。

联系方式

如需反馈或技术支持，请联系 support@your-domain.com。