Google Workspace Skill

概述

通过 mcp-gsuite MCP 服务器与 Google 全家桶集成：

• 📧 Gmail: 读取/发送邮件、搜索、标签管理
• 📅 Google Calendar: 查看/创建/修改日程
• 📁 Google Drive: 文件列表、上传、搜索
• 📊 Google Sheets: 读写电子表格（适合 KL8 回测数据导出）

前置配置（首次使用必须手动完成）

1. 创建 Google Cloud 项目

1. 访问 console.cloud.google.com
2. 创建新项目: KL8-Assistant
3. 启用 API: Gmail API, Calendar API, Drive API, Sheets API
4. 创建 OAuth 2.0 凭据（桌面应用类型）
5. 下载 credentials.json

2. 放置凭据文件

New-Item -Path "C:\Users\zhiwei.chen\AppData\Roaming\mcp-gsuite" -ItemType Directory -Force
# 将下载的 credentials.json 复制到上述目录
Copy-Item "~/Downloads/credentials.json" "C:\Users\zhiwei.chen\AppData\Roaming\mcp-gsuite\"

3. 首次授权

npx -y mcp-gsuite@latest
# 会打开浏览器进行 OAuth 授权
# 授权完成后会生成 token.json

工作流程

Gmail 操作

读取未读邮件:    gmail/list_emails (maxResults=10, query="is:unread")
搜索邮件:        gmail/search_emails (query="from:boss@company.com")
发送邮件:        gmail/send_email (to, subject, body)
回复邮件:        gmail/reply_email (messageId, body)

Calendar 操作

查看今日日程:    calendar/list_events (timeMin=today, timeMax=tomorrow)
创建日程:        calendar/create_event (summary, start, end, description)
查找空闲时间:    calendar/find_free_slots

Drive + Sheets 操作（KL8 专用）

导出回测结果到 Sheets:
1. 从 backend/data/backtest.db 读取回测数据
2. 转换为 CSV 格式
3. 上传到 Google Drive → 转换为 Google Sheets
4. 设置共享权限（可选）

KL8 系统集成场景

场景	操作
回测报告定期发送	每周生成报告 → 发送 Gmail
提醒当天预测号码	每天早上 → Calendar 提醒
数据备份	历史数据 → Google Drive
多人协作回测分析	数据 → Google Sheets 共享