麦克风套件增强版

Name: 麦克风套件增强版
Author: ajramos

作者：ajramos10 星标更新：2025-06-14

安装使用来源：spider==github.com

项目介绍

mcp-gsuite-enhanced

与Google Workspace全面交互的MCP服务器，具有完整的Gmail API覆盖范围和高级电子邮件管理功能

与Google产品交互的MCP服务器，具有完整的Gmail API覆盖范围（总共27个工具），高级电子邮件管理、标签操作、归档工作流以及工作的Google Meet集成。

🚀 快速开始

在5分钟内启动Google Workspace MCP！

先决条件

安装Python 3.13+ 和 uv
具有Gmail/日历访问权限的Google账户
推荐使用Cursor IDE或任何MCP客户端

第一步：克隆并安装

git clone https://github.com/ajramos/mcp-gsuite-enhanced.git
cd mcp-gsuite-enhanced
uv sync

第二步：设置Google云（一次性设置）

转到Google Cloud控制台
创建一个项目，并启用Gmail API + Google Calendar API
创建OAuth 2.0桌面凭证
下载并保存为**.gauth.json**在项目目录中

第三步：配置账户

创建**.accounts.json**：

{
  "accounts": [
    {
      "email": "your-email@gmail.com",
      "account_type": "personal", 
      "extra_info": "主要个人Gmail和日历"
    }
  ]
}

第四步：快速配置检查

python cursor_setup.py

这会显示认证状态并生成Cursor配置。

第五步：认证

python auth_setup.py your-email@gmail.com

打开浏览器进行OAuth流程 - 授权权限即可完成！

第六步：在Cursor中配置

复制步骤4中的JSON配置
Cursor → 设置（Cmd+,）→ 搜索"MCP"
粘贴配置并重启Cursor

第七步：测试它！🎉

在Cursor中尝试这些命令：

"列出我的日历"
"显示我未读邮件"
"创建带有Google Meet链接的测试会议"

**就这样！**你现在有了完整的Google Workspace集成，包括自动Google Meet链接！

🎯 增强功能 v2.0.0

🚀 完整的Gmail API覆盖范围（总计27个工具）

22个Gmail工具 - 完整的电子邮件生命周期管理
5个日历工具 - 与Google Meet的完整日历集成

✨ 高级电子邮件管理

✅ 直接通过Gmail发送电子邮件
✅ 标签管理 - 创建、应用、移除和删除标签
✅ 归档工作流 - 归档、恢复和管理电子邮件生命周期
✅ 草稿管理 - 列出、创建和管理电子邮件草稿
✅ 批量操作 - 高效地归档多封电子邮件
✅ 电子邮件状态 - 标记为已读/未读，移动到垃圾箱

🎪 增强的日历功能

✅ 工作的Google Meet集成 - 日历事件中的自动Meet链接
✅ 修复了update_calendar_event - 之前损坏，现在完全可用
✅ 改进的参会者处理 - 修复了电子邮件解析错误
✅ 设置实用程序 - auth_setup.py和cursor_setup.py用于轻松配置

功能与能力

v2.0.0提供了全面的Google Workspace自动化，共有27个工具：

1. 通用

支持多个Google账户
使用OAuth 2.0认证并刷新令牌
全面的错误处理和日志记录

2. Gmail (22个工具) 📧

电子邮件管理

通过Gmail直接发送电子邮件，支持抄送/密送
使用灵活搜索查询电子邮件（未读、发件人、日期、附件）
通过ID检索完整的电子邮件内容或一次检索多封电子邮件
将电子邮件标记为已读/未读
将电子邮件移动到垃圾箱

草稿管理

创建新的草稿电子邮件，包含收件人、主题、正文和抄送选项
列出所有草稿电子邮件及其详细信息
删除草稿电子邮件
回复现有电子邮件（立即发送或保存为草稿）

标签管理 🏷️

列出所有Gmail标签（系统+自定义）
创建新的自定义标签
将标签应用于电子邮件
从电子邮件中移除标签
永久删除自定义标签

归档工作流 📁

归档单封电子邮件（从收件箱中移除）
批量归档多封电子邮件
列出已归档的电子邮件
将已归档的电子邮件恢复到收件箱

附件管理

下载并保存电子邮件附件到本地文件
批量保存来自不同电子邮件的多个附件

3. 日历 (5个工具) 📅

列出您账户可用的日历
获取指定时间范围内的日历事件
创建新的日历事件，包含参会者和自动Google Meet链接 🎪
更新现有日历事件（摘要、时间、参会者） ⚡
删除日历事件
完整的时区支持，适用于国际调度

💡 示例提示

📧 Gmail操作 (22个工具)

电子邮件搜索与检索
- "检索我最新的未读消息"
- "搜索我来自Scrum Master的电子邮件"
- "显示本周所有带有附件的电子邮件"
- "获取关于ABC的电子邮件并总结"
电子邮件编写与管理
- "给john@company.com发送一封关于项目更新的电子邮件"
- "写一封友好的回复给Alice的最后电子邮件并保存为草稿"
- "将来自marketing@company.com的所有电子邮件标记为已读"
- "将那封垃圾邮件移到垃圾箱"
标签管理 🏷️
- "创建一个名为'Project Alpha'的标签并将它应用到关于项目的电子邮件"
- "显示我所有的自定义标签"
- "从昨天的电子邮件中移除'紧急'标签"
- "删除未使用的'旧项目'标签"
归档工作流 📁
- "归档上周新闻通讯的所有电子邮件"
- "显示我第三季度的已归档电子邮件"
- "恢复那封重要的电子邮件回到我的收件箱"
- "一次性归档这5封电子邮件：[电子邮件ID]"
附件管理
- "下载所有包含'invoice'的电子邮件附件"
- "保存来自john@company.com本周所有电子邮件的附件"

📅 日历管理

议程与安排
- "明天我有什么议程？"
- "查看下周私人账户的家庭议程"
- "我需要为Tim安排下周的2小时活动。建议一些时间段"
带有Google Meet的事件创建 🎪
- "创建下周五与John的会议并包含Google Meet链接"
- "安排周四下午2点的客户通话并邀请john@company.com"
- "每周一上午9点创建团队站会并包含Google Meet"
- "创建明天下午3点的项目评审会议并包含Google Meet链接，邀请整个团队"
事件更新 ⚡ (增强功能)
- "更新我的下午3点会议，添加Sarah作为参会者"
- "更新季度规划会议，更改时间为下午4点，并添加sarah@company.com"
- "更改明天团队会议的地点为会议室B"
高级日历查询
- "列出下周所有带有Google Meet链接的日历事件"
- "显示这个月我所有的重复会议"
- "查找下周计划的所有外部参会者的会议"

安装

方案1：通过Smithery快速安装 (推荐) 📦

最快的方式开始使用MCP GSuite增强版：

npx -y @smithery/cli install mcp-gsuite-enhanced --client claude

这将自动：

✅ 下载并安装最新版本
✅ 为您配置Claude Desktop
✅ 设置MCP服务器条目

方案2：手动安装 🔧

对于高级用户或开发目的：

Cursor IDE设置

对于Cursor IDE用户，使用设置辅助脚本：

python cursor_setup.py

这将生成正确的MCP配置并提供逐步说明，以将其添加到您的Cursor设置中。

使用uv的手动安装 (推荐)

git clone https://github.com/ajramos/mcp-gsuite-enhanced
cd mcp-gsuite-enhanced
uv sync

使用pip的手动安装

git clone https://github.com/ajramos/mcp-gsuite-enhanced
cd mcp-gsuite-enhanced
pip install -e .

设置Google身份验证

Google云配置

您需要创建一个Google云项目并配置OAuth2凭证：

步骤1：创建Google云项目

转到Google Cloud控制台
创建一个新的项目或选择现有的项目
启用所需的API：
- 转到“API和服务” → “库”
- 搜索**"Gmail API"**并启用它
- 搜索**"Google Calendar API"**并启用它

步骤2：设置OAuth 2.0凭证

转到“API和服务” → “凭证”
单击“创建凭证” → “OAuth客户端ID”
选择**"桌面应用程序"**作为应用程序类型
如果提示，请配置OAuth同意屏幕
下载凭证JSON文件并保存为**.gauth.json**在您的项目目录中

步骤3：配置您的Google账户

在您的项目目录中创建一个.accounts.json文件，以指定要使用的Google账户：

{
  "accounts": [
    {
      "email": "your-work@company.com",
      "account_type": "work",
      "extra_info": "公司日历的工作账户"
    },
    {
      "email": "your-personal@gmail.com", 
      "account_type": "personal",
      "extra_info": "家庭日历的个人账户"
    }
  ]
}

字段解释：

email：您的Google账户电子邮件地址
account_type：类别如"工作"、"个人"等（有助于组织）
extra_info：帮助AI理解此账户用途的附加上下文

步骤4：认证您的Google账户

一旦您有了.gauth.json和.accounts.json文件，为每个账户运行认证设置：

python auth_setup.py your-work@company.com
python auth_setup.py your-personal@gmail.com

该脚本将自动处理OAuth流程，并将您的凭据安全存储在.oauth2.{email}.json文件中。

⚠️ 安全警告：切勿将凭据文件（.gauth.json，.accounts.json，.oauth2.*.json）提交到版本控制系统！将它们添加到您的.gitignore文件中，以防意外暴露敏感认证数据。

OAuth 2.0范围 (自动)

服务器自动请求这些权限 - 无需手动配置：

[
  "openid",
  "https://www.googleapis.com/auth/userinfo.email",
  "https://mail.google.com/",
  "https://www.googleapis.com/auth/calendar"
]

这些范围允许服务器：

✅ 访问您的Gmail（读取、发送、管理草稿）
✅ 管理您的Google日历（创建、更新、删除事件）
✅ 自动创建Google Meet链接
✅ 识别您的Google账户

配置示例

Claude Desktop (增强版)

将以下内容添加到您的Claude Desktop配置中：

{
  "mcpServers": {
    "mcp-gsuite-enhanced": {
      "command": "uv",
      "args": [
        "--directory", 
        "/path/to/mcp-gsuite-enhanced",
        "run",
        "mcp-gsuite-enhanced"
      ]
    }
  }
}

Claude Desktop (Smithery安装)

如果您是通过Smithery安装的，您的配置将自动处理！无需手动设置。

使用uvx (增强版)

{
  "mcpServers": {
    "mcp-gsuite-enhanced": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/mcp-gsuite-enhanced",
        "run",
        "mcp-gsuite-enhanced"
      ]
    }
  }
}

增强的Google Meet集成

增强版自动为新日历事件创建Google Meet链接：

{
  "calendar_id": "primary",
  "summary": "团队站会",
  "start_time": "2024-01-15T10:00:00Z",
  "end_time": "2024-01-15T10:30:00Z",
  "attendees": "team@company.com,lead@company.com",
  "create_meet_link": true
}

结果是一个日历事件，其中包含：

✅ 自动Google Meet链接
✅ 电话拨入号码
✅ 会议PIN码
✅ 所有参会者被邀请

开发

为了设置开发环境：

git clone https://github.com/ajramos/mcp-gsuite-enhanced
cd mcp-gsuite-enhanced
uv sync
uv run mcp-gsuite-enhanced

使用MCP Inspector调试

由于MCP服务器通过stdio运行，调试可能会很困难。我们强烈建议使用MCP Inspector以获得最佳调试体验。

您可以使用以下命令通过npm启动MCP Inspector：

npx @modelcontextprotocol/inspector uv --directory /path/to/mcp-gsuite-enhanced run mcp-gsuite-enhanced

启动后，Inspector将显示一个URL，您可以在浏览器中访问该URL以开始调试。

服务器日志

您还可以使用以下命令监视服务器日志：

# macOS
tail -n 20 -f ~/Library/Logs/Claude/mcp-server-mcp-gsuite-enhanced.log

# Linux 
tail -n 20 -f ~/.config/Claude/logs/mcp-server-mcp-gsuite-enhanced.log

# Windows
Get-Content "$env:APPDATA\Claude\logs\mcp-server-mcp-gsuite-enhanced.log" -Wait -Tail  20

安全

所有认证都通过本地OAuth 2.0处理
凭据安全存储在本地文件中
除了Google的API外，没有数据发送给第三方
支持多个Google账户，具有隔离的凭据

致谢

基于Markus Pfundstein的mcp-gsuite。

通过全面的Gmail API覆盖范围、Google Meet集成和改进的功能由Angel Ramos增强。

感谢

原始项目：mcp-gsuite by Markus Pfundstein (MIT License)
Gmail功能灵感来自社区MCP实现，包括Gmail-MCP-server
所有代码独立实现，使用官方Google API文档
根据MIT许可 - 未包含GPL代码

许可证

MIT许可 - 详情见LICENSE文件。

贡献

欢迎贡献！请随时提交Pull Request。

支持

如果您遇到增强功能的问题：

检查日志 使用上述调试说明
验证认证 运行python auth_setup.py <your-email>
打开问题 包括：
- 您的操作系统
- Python版本
- 错误消息或日志
- 重现问题的步骤

对于一般的MCP问题，请参阅模型上下文协议文档。