STARWARCLOUD STARWAR.AI
返回市场
谷歌套件-MCP

谷歌套件-MCP

作者：aaronsb107 星标更新：2025-11-05
安装使用来源：spider==github.com

项目介绍

Google Workspace MCP 服务器

机器人助手

此模型上下文协议（MCP）服务器使您能够掌控您的Google Workspace。一旦连接您的账户——这是一个简单、安全的过程，只需一分钟——您就可以开始使用了。在后台，它会确保您的连接安全且活跃，因此您可以专注于完成任务，而不是管理登录和权限。

以从未想象过的方式掌控您的Gmail收件箱。想要获取上季度的提案？几秒钟内即可找到。被新闻通讯淹没？它们会自动分类到文件夹中。需要跟踪重要线程的响应？标签和过滤器为您处理一切。从撰写完美的电子邮件到与团队管理对话，一切都井然有序。通过简化附件处理，您可以轻松地查找和管理电子邮件附件，而系统则负责处理所有复杂的元数据。

您的日历成为日常忙碌中的可靠伙伴。不再有重复预订会议或时区混淆的问题。计划团队同步会议？它会找到最佳时间槽。运行定期研讨会？设置一次即可。即使计划改变，找到适合每个人的新时间也快速且无痛。无尽的“何时有空？”电子邮件已成为过去。

将Google Drive从文件倾倒处转变为您的数字指挥中心。每个文档都有其位置，每个文件夹都讲述一个故事。仅与正确的人共享文件——再无“谁可以编辑这个？”的困惑。寻找上周会议上的演示文稿？搜索不仅限于名称，还包括文件内容。无论您是在组织小型项目还是管理大量文档，一切都保持在您需要的位置。

关键功能

  • Gmail 管理：使用高级过滤和标签管理进行搜索、发送和组织电子邮件
  • 日历操作：创建、更新和管理事件，具有完整的调度能力
  • 驱动器集成：上传、下载、搜索和管理文件，具有权限控制
  • 联系人访问：检索和管理您的Google联系人
  • 安全认证：带有自动令牌刷新的OAuth 2.0 流程
  • 多账户支持：同时管理多个Google账户

快速入门

先决条件

  1. Google Cloud 项目设置：

    • 在Google Cloud 控制台中创建一个项目
    • 启用Gmail API、日历API和驱动器API
    • 将OAuth同意屏幕配置为“外部”
    • 将自己添加为测试用户

  2. OAuth 凭据：

    • 创建OAuth 2.0 凭据
    • 选择“Web 应用程序”类型
    • 设置重定向URI为：http://localhost:8080
    • 保存您的客户端ID和客户端密钥

  3. 本地设置：

    • 安装Docker
    • 创建配置目录：mkdir -p ~/.mcp/google-workspace-mcp
      • 如果目录已存在，请确保您的用户拥有该目录

配置

将服务器添加到您的MCP客户端配置：

对于Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json)：

{
  "mcpServers": {
    "google-workspace-mcp": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-p", "8080:8080",
        "-v", "~/.mcp/google-workspace-mcp:/app/config",
        "-v", "~/Documents/workspace-mcp-files:/app/workspace",
        "-e", "GOOGLE_CLIENT_ID",
        "-e", "GOOGLE_CLIENT_SECRET",
        "-e", "LOG_MODE=strict",
        "ghcr.io/aaronsb/google-workspace-mcp:latest"
      ],
      "env": {
        "GOOGLE_CLIENT_ID": "your-client-id.apps.googleusercontent.com",
        "GOOGLE_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

对于Cline (~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json)：

{
  "mcpServers": {
    "google-workspace-mcp": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-p", "8080:8080",
        "-v", "~/.mcp/google-workspace-mcp:/app/config",
        "-v", "~/Documents/workspace-mcp-files:/app/workspace",
        "-e", "GOOGLE_CLIENT_ID",
        "-e", "GOOGLE_CLIENT_SECRET",
        "-e", "LOG_MODE=strict",
        "ghcr.io/aaronsb/google-workspace-mcp:latest"
      ],
      "env": {
        "GOOGLE_CLIENT_ID": "your-client-id.apps.googleusercontent.com",
        "GOOGLE_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

关键配置说明：

  • 端口映射 -p 8080:8080 是必需的，用于处理OAuth回调
  • 使用实际的Google Cloud OAuth凭据替换占位符凭据
  • 推荐但非必需的 LOG_MODE=strict 设置

日志模式：

  • normal（默认）：根据每个日志级别使用适当的控制台方法
  • strict：将所有非JSON-RPC消息路由到stderr

认证

  1. 配置后重启您的MCP客户端
  2. 请求您的AI助手“添加我的Google账户”
  3. 按照OAuth流程：
    • 点击提供的授权URL
    • 登录Google并授予权限
    • 从成功页面复制授权代码
    • 提供代码以完成认证

架构

OAuth 流程

服务器实现了一个安全的OAuth 2.0 流程：

  1. 回调服务器：自动启动在 localhost:8080 处处理OAuth重定向
  2. 授权：生成Google OAuth URL用于用户认证
  3. 令牌管理：安全存储并自动刷新访问令牌
  4. 多账户：支持具有隔离令牌存储的多个Google账户

文件管理

文件按结构化工作空间组织：

~/Documents/workspace-mcp-files/
├── [email@domain.com]/
│   ├── downloads/        # 从Drive下载的文件
│   └── uploads/         # 准备上传的文件
├── [email2@domain.com]/
│   ├── downloads/
│   └── uploads/
└── shared/
    └── temp/           # 临时文件（自动清理）

可用工具

账户管理

  • list_workspace_accounts - 列出配置的账户及其认证状态
  • authenticate_workspace_account - 添加并认证Google账户
  • remove_workspace_account - 移除账户及其相关令牌

Gmail 操作

  • search_workspace_emails - 使用过滤器进行高级邮件搜索
  • send_workspace_email - 发送带附件和格式的电子邮件
  • manage_workspace_draft - 创建、更新和管理邮件草稿
  • manage_workspace_label - 创建和管理Gmail标签
  • manage_workspace_label_assignment - 对消息应用/移除标签
  • manage_workspace_label_filter - 创建自动化标签过滤器
  • get_workspace_gmail_settings - 访问Gmail账户设置

日历操作

  • list_workspace_calendar_events - 列出和搜索日历事件
  • get_workspace_calendar_event - 获取详细事件信息
  • create_workspace_calendar_event - 创建带有参会者的事件
  • manage_workspace_calendar_event - 更新事件并回应邀请
  • delete_workspace_calendar_event - 删除日历事件

驱动器操作

  • list_drive_files - 带过滤和分页的文件列表
  • search_drive_files - 跨驱动器内容的全文搜索
  • upload_drive_file - 带元数据和权限的文件上传
  • download_drive_file - 带格式转换的文件下载
  • delete_drive_file - 删除文件和文件夹
  • create_drive_folder - 创建组织化的文件夹结构
  • update_drive_permissions - 管理文件共享和权限

联系人操作

  • get_workspace_contacts - 检索联系人信息和详情

参见API 文档以获取详细的使用示例。

开发

本地开发

对于本地开发和测试：

# 克隆仓库
git clone https://github.com/aaronsb/google-workspace-mcp.git
cd google-workspace-mcp

# 构建本地Docker镜像
./scripts/build-local.sh

# 在配置中使用本地镜像
# 将 "ghcr.io/aaronsb/google-workspace-mcp:latest" 替换为 "google-workspace-mcp:local"

故障排除

常见问题

认证错误：

  • 验证OAuth凭据是否正确配置
  • 确保API（Gmail、日历、驱动器）在Google Cloud 中启用
  • 检查您是否作为测试用户添加到OAuth同意屏幕
  • 确认重定向URI设置为 http://localhost:8080

连接问题：

  • 验证端口8080可用且未被防火墙阻止
  • 确保Docker有权绑定到端口8080
  • 检查配置目录是否存在且具有正确的权限

Docker 问题： macOS：

  • 从命令行完全关闭Docker：pkill -SIGHUP -f /Applications/Docker.app 'docker serve'
  • 重新启动Docker Desktop
  • 重新启动您的MCP客户端（Claude Desktop 或 Cursor/Cline等）

Windows：

  • 打开任务管理器（Ctrl+Shift+Esc）
  • 查找并结束“Docker Desktop”进程
  • 从开始菜单重新启动Docker Desktop
  • 重新启动您的MCP客户端（Claude Desktop 或 Cursor/Cline等）

令牌问题：

  • 如果令牌失效，删除并重新认证账户
  • 验证Google Cloud 中的API范围是否正确配置
  • 检查令牌过期和刷新逻辑

获取帮助

额外的支持：

安全性

  • OAuth 凭据安全存储在MCP客户端配置中
  • 访问令牌加密并本地存储
  • 自动令牌刷新防止凭证暴露
  • 每个用户维护自己的Google Cloud 项目
  • 不向外部服务器传输任何凭证

许可

MIT 许可证 - 详情见LICENSE文件。

贡献

欢迎贡献！请参阅CONTRIBUTING.md以获取指南。