mcp-gsuite MCP服务器

与Google产品交互的MCP服务器。

示例提示词

目前，此MCP服务器支持Gmail和日历集成，并具备以下功能：

1. 通用

• 多个Google账户

2. Gmail

• 获取您的Gmail用户信息
• 使用灵活的搜索查询邮件（例如，未读、来自特定发件人、日期范围、带附件）
• 根据ID检索完整的电子邮件内容
• 创建新的草稿邮件，包括收件人、主题、正文和抄送选项
• 删除草稿邮件
• 回复现有邮件（可以选择立即发送或保存为草稿）
• 一次根据其ID检索多个邮件。
• 将多个附件从邮件保存到本地系统。

3. 日历

• 管理多个日历
• 在指定时间范围内获取日历事件
• 创建日历事件，包括开始和结束时间、标题、地点和描述
• 更新现有事件或创建新事件（如果重复）
• 获取所有当前用户的Google日历
• 根据ID检索单个事件
• 删除事件

配置选项

MCP服务器可以通过命令行选项指定自定义路径来配置身份验证和账户信息：

• --gauth-file：指定包含OAuth2客户端配置的.gauth.json文件路径。默认为./.gauth.json。
• --accounts-file：指定包含Google账户信息的.accounts.json文件路径。默认为./.accounts.json。
• --credentials-dir：指定在成功身份验证后存储OAuth凭证的目录。默认为当前工作目录，每个账户使用子目录.oauth.{email}.json。

这些选项在开发和测试场景中非常有用，特别是在需要管理多个环境或不同的配置集时。

发展

构建与发布

准备将包进行分发：

1. 同步依赖项并更新锁定文件：

uv sync

2. 构建包分布：

uv build

这将在dist/目录中创建源代码和轮分布。

3. 发布到PyPI：

uv publish

注意：您需要通过环境变量或命令行标志设置PyPI凭据：

• 令牌：--token 或 UV_PUBLISH_TOKEN
• 或用户名/密码：--username/UV_PUBLISH_USERNAME 和 --password/UV_PUBLISH_PASSWORD

调试

由于MCP服务器通过标准输入输出运行，调试可能具有挑战性。为了获得最佳调试体验，我们强烈推荐使用MCP Inspector。

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

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

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

您还可以通过以下命令查看服务器日志：

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