mcp-gee-sweet Skill 技能

技能简介

mcp-gee-sweet 是一款专为 Google Workspace 深度集成而设计的开源 MCP（Model Context Protocol）服务器，由社区开发者 khuisman 构建和维护。它填补了 Google 官方 MCP 预览版的深度空白——官方版仅提供浅层 CRUD 操作，而 mcp-gee-sweet 实现了公式级 Sheets 读取、结构化 Docs 支持、完整 Drive 和 Calendar 覆盖，并内置了本地缓存与双向同步能力。

核心能力

1. Google Sheets 公式直接读取：不仅读取单元格数值，还能解析 =VLOOKUP()、=SUM()、=IF() 等公式本身，这是官方 MCP 完全不支持的能力。
2. 8 种图表类型的结构化读写：支持批量读写、行列操作，以及图表的创建与属性修改。
3. Google Docs HTML→AST→文档管道：支持复杂表格（colspan/rowspan）、主题样式、命名样式，以及 HTML/Markdown 到 Google Docs 的完整双向转换。
4. 本地缓存加速：重复读取返回时间约 2ms（从本地缓存），无需每次调用 API。
5. 本地文件夹↔Google Drive 双向同步：监控本地文件夹变化并同步到 Drive，或将 Drive 内容同步到本地。
6. Google Drive 完整文件操作：38 个工具支持文件操作、权限分享、版本历史。
7. Google Calendar 完整覆盖：17 个工具支持跨多日历的日程 CRUD 和空闲时间查找，官方 MCP 完全未覆盖此服务。
8. Docker SSE 模式：支持多客户端共享长运行服务器，适合团队场景。

安装配置

环境要求

• Python 3.10+
• uv 包管理器（推荐）或 Docker
• Google Cloud 项目开启了以下 API：Sheets API、Drive API、Docs API、Calendar API
• OAuth 2.0 凭据文件（credentials.json）

安装方式一：uv（本地开发 / 个人使用）

git clone https://github.com/khuisman/mcp-gee-sweet.git
cd mcp-gee-sweet
uv sync

然后在 MCP 客户端配置文件中添加 stdio 传输配置，服务器会在首次运行时自动打开浏览器进行 OAuth 授权。

安装方式二：Docker（团队共享服务器）

git clone https://github.com/khuisman/mcp-gee-sweet.git
cd mcp-gee-sweet
make build
make start

启动后服务器监听 SSE 端口 47000，多个客户端可共享同一实例。

MCP 客户端配置（stdio 模式）

在 MCP 客户端配置文件中添加：

{
  "mcpServers": {
    "mcp-gee-sweet": {
      "command": "uvx",
      "args": ["mcp-gee-sweet"]
    }
  }
}

SSE 模式则配置为：

{
  "mcpServers": {
    "mcp-gee-sweet": {
      "url": "http://localhost:47000/sse"
    }
  }
}

使用步骤

1. 创建 Google Cloud 项目：在 Google Cloud Console 新建项目，开启 Sheets、Drive、Docs、Calendar 四个 API。
2. 下载 OAuth 凭据：在凭据页面创建 OAuth 2.0 客户端 ID，下载 JSON 文件并重命名为 credentials.json，放入项目根目录。
3. 首次授权：首次运行服务器时，会自动打开系统浏览器进行 OAuth 授权流程，授权后凭据缓存到本地。
4. 启动服务：根据安装方式执行 uvx mcp-gee-sweet（本地 stdio）或 make start（Docker SSE）。
5. 在 AI 助手中使用：在支持 MCP 协议的 AI 助手中（Claude Desktop、Claude Code 等），选择已配置的 mcp-gee-sweet 服务器，即可通过自然语言操作 Google Workspace 文档。

适用场景

1. 财务与数据分析师：直接读取 Sheet 中的公式和计算逻辑，而不只是最终数值，便于审计和自动化报告生成。
2. 文档自动化团队：将 Markdown/HTML 文档批量导入 Google Docs，保留格式、表格和样式，适合内容管理系统。
3. 项目管理：跨多个日历查询空闲时间，自动创建会议并同步到团队 Drive 文档，减少协调成本。
4. 本地-云端同步工作流：本地开发文档自动同步到 Google Drive，团队成员无需手动上传下载。
5. AI 应用开发者：构建以 Google Workspace 为数据源的 AI Agent，实现自然语言驱动的办公自动化。

适用人群

• 需要深度操作 Google Sheets（含公式/图表）的 AI 应用开发者
• 文档团队需要批量处理 Google Docs 格式转换
• 需要 Google Drive/Calendar 完整 API 覆盖的自动化场景
• 已用 Google Workspace 且希望本地缓存加速的效率用户

工作原理

mcp-gee-sweet 基于 MCP 协议，通过 stdio（单人本地）或 SSE（团队共享）两种传输方式与 AI 客户端通信。服务器内部维护一个本地缓存层，对 Google API 响应进行 TTL 缓存，重复读取从缓存返回（约 2ms 延迟）。Sheets 工具通过 Google Sheets API v4 读取公式与数据；Docs 工具通过 Google Docs API 解析文档结构体；Drive 和 Calendar 分别通过对应 REST API 实现完整覆盖。所有工具均通过 MCP 协议的标准工具调用接口暴露给 AI 助手。

官方链接

• GitHub：https://github.com/khuisman/mcp-gee-sweet
• 完整文档：https://khuisman.github.io/mcp-gee-sweet/
• PyPI：https://pypi.org/project/mcp-gee-sweet/