Gmail MCP服务器
这个项目是Gmail的Spring Boot MCP(模型上下文协议)服务器。它提供了各种工具,通过 GMailer 类。此外它还包括客户端, ClientStdio,以测试MCP服务器功能。
特性
- GMailer工具:
- trashEmail:根据电子邮件的ID将其移动到垃圾箱。 - markEmailAsRead:根据电子邮件的ID将其标记为已读。 - sendEmail:向指定收件人发送电子邮件。 - getUnreadMessages:检索未读邮件。 - readEmail:读取给定ID的电子邮件。
- 客户标准:使用标准I/O测试MCP服务器功能的客户端。
先决条件
- Java 17或更高版本
- 梅文
- Gmail API凭据
设置
- 克隆存储库:
git clone
cd - 配置Gmail API凭据:
- 创建新的Google Cloud项目 - 启用Gmail API - 配置OAuth同意屏幕 - 选择“外部”。但是,我们不会发布该应用程序。 - 将您的个人电子邮件地址添加为“测试用户”。 - 添加OAuth作用域 https://www.googleapis.com/auth/gmail/modify - 创建OAuth客户端ID 适用于应用程序类型“桌面应用程序” - 下载客户端OAuth密钥的JSON文件 - 将密钥文件重命名为 credentials.json 并将其保存到安全位置的本地计算机上。记下位置。 - 放置您的 credentials.json 文件在 src/main/resources 目录。
- 构建项目:
mvn clean install运行MCP服务器
要启动MCP服务器,请运行以下命令:
mvn spring-boot:run使用ClientStdio进行测试
这 ClientStdio 类可用于测试MCP服务器功能。它使用标准I/O与服务器交互。
首先使用以下命令构建项目:
mvn clean install -DskipTests然后运行 ClientStdio 类。
许可证
该项目根据MIT许可证获得许可。请参阅 LICENSE 文件以获取详细信息。
