🚀 mcp - gsuite MCP服务器
与Google产品交互的MCP服务器，借助它可实现与Gmail和日历等Google服务的便捷集成。
🚀 快速开始
此MCP服务器支持Gmail和日历集成，能帮助用户更高效地与Google产品进行交互。
✨ 主要特性
通用
- 支持多个Google账户。
Gmail
- 获取您的Gmail用户信息。
- 使用灵活搜索查询邮件（例如，未读、来自特定发件人、日期范围、带有附件）。
- 按ID检索完整的电子邮件内容。
- 创建新的草稿邮件，带有收件人、主题、正文和抄送选项。
- 删除草稿邮件。
- 回复现有邮件（可以立即发送或保存为草稿）。
- 一次按其ID检索多个邮件。
- 将多个附件从邮件保存到本地系统。
日历
- 管理多个日历。
- 在指定时间范围内获取日历事件。
- 创建带有以下内容的日历事件：
- 标题，开始/结束时间。
- 可选位置和描述。
- 可选与会者。
- 自定义时区支持。
- 通知偏好设置。
- 删除日历事件。
示例提示
可以尝试以下示例提示来体验服务器功能：
- 获取我最新的未读消息。
- 搜索来自Scrum Master的邮件。
- 获取会计的所有邮件。
- 查看关于ABC的邮件并进行摘要。
- 写一封感谢Alice最后一封邮件的回复并保存为草稿。
- 回复Bob的邮件，内容为“非常感谢”。将其作为草稿存储。
- 我明天的日程安排是什么？
- 这周我有哪些会议？
- 在我的日历中找到所有与客户A相关的事件。
📚 详细文档
MCP服务器可以配置为指定自定义路径用于身份验证和账户信息的选项：
--gauth-file：指定包含OAuth2客户端配置的.gauth.json文件的路径。默认是./.gauth.json。--accounts-file：指定包含Google账户信息的.accounts.json文件的路径。默认是./.accounts.json。--credentials-dir：指定在成功身份验证后存储OAuth凭证的目录。默认是在当前工作目录中，每个账户都有一个子目录.oauth.{email}.json。
这些选项在开发和测试场景中特别有用，特别是在需要不同配置或不适合默认路径的环境中部署时。
🔧 技术细节
构建和发布
要准备分发包，可按以下步骤操作：
- 同步依赖项并更新锁定文件：
uv sync
- 构建包分布：
uv build
这将在dist/目录中创建源代码和轮式发行版。
3. 发布到PyPI：
uv publish
注意：您需要通过环境变量或命令标志设置PyPI凭据：
- 令牌：
--token或UV_PUBLISH_TOKEN。 - 或用户名/密码：
--username/UV_PUBLISH_USERNAME和--password/UV_PUBLISH_PASSWORD。
调试
由于MCP服务器通过stdio运行，调试可能具有挑战性。为了获得最佳调试体验，我们强烈推荐使用MCP Inspector。
您可以通过以下命令启动MCP Inspector：
npx @modelcontextprotocol/inspector uv --directory /path/to/mcp-gsuite run mcp-gsuite
启动后，Inspector会显示一个URL，您可以在浏览器中访问该URL以开始调试。
您还可以通过以下命令查看服务器日志：
tail -n 20 -f ~/Library/Logs/Claude/mcp-server-mcp-gsuite.log