Gmail邮件管理服务

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凭据

设置

1. 克隆存储库:

   复制

   git clone <repository-url>
   cd <repository-directory>
   

2. 配置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 目录。

3. 构建项目:

   复制

   mvn clean install
   

运行MCP服务器

要启动MCP服务器，请运行以下命令：

mvn spring-boot:run

使用ClientStdio进行测试

这 ClientStdio 类可用于测试MCP服务器功能。它使用标准I/O与服务器交互。

首先使用以下命令构建项目：

mvn clean install -DskipTests

然后运行 ClientStdio 类。

许可证

该项目根据MIT许可证获得许可。请参阅 LICENSE 文件以获取详细信息。