Gmail MCP 服务器

本项目是一个用于 Gmail 的 Spring Boot MCP (模型上下文协议) 服务器。它通过 GMailer 类提供各种与 Gmail 交互的工具。此外，它还包含一个客户端 ClientStdio，用于测试 MCP 服务器的功能。

功能

• GMailer 工具:

  • trashEmail: 将电子邮件移动到垃圾箱，给定其 ID。
  • markEmailAsRead: 将电子邮件标记为已读，给定其 ID。
  • sendEmail: 向指定收件人发送电子邮件。
  • getUnreadMessages: 获取未读邮件。
  • readEmail: 读取电子邮件，给定其 ID。

• ClientStdio: 一个使用标准 I/O 测试 MCP 服务器功能的客户端。

前提条件

• Java 17 或更高版本
• Maven
• 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 文件。