Gmail MCP Server

Gmail MCP Server

site icon
2025.04.06 0
Java邮件管理Gmail 集成交流协作
Gmail MCP Server 是一个基于 Spring Boot 的 MCP(Model Context Protocol)服务器,专为 Gmail 设计。它提供了多种工具,通过 `GMailer` 类与 Gmail 进行交互,包括邮件管理、发送和读取等功能。此外,它还包含一个客户端 `ClientStdio`,用于测试 MCP 服务器的功能。
View on GitHub

Overview

基本能力

产品定位

Gmail MCP Server 是一个用于与 Gmail 交互的 MCP 服务器,提供邮件管理、发送和读取等功能。

核心功能

  • GMailer Tools:
  • trashEmail: 根据邮件 ID 将邮件移至垃圾箱。
  • markEmailAsRead: 根据邮件 ID 将邮件标记为已读。
  • sendEmail: 向指定收件人发送邮件。
  • getUnreadMessages: 获取未读邮件。
  • readEmail: 根据邮件 ID 读取邮件内容。
  • ClientStdio: 一个用于通过标准 I/O 测试 MCP 服务器功能的客户端。

适用场景

  • 需要自动化管理 Gmail 邮件的场景。
  • 开发需要与 Gmail API 集成的应用程序。
  • 测试 Gmail 相关功能的开发环境。

工具列表

  • GMailer: 提供与 Gmail 交互的核心功能。
  • ClientStdio: 用于测试 MCP 服务器功能的客户端。

常见问题解答

  • 如何配置 Gmail API 凭证?
  • 创建 Google Cloud 项目并启用 Gmail API。
  • 配置 OAuth 同意屏幕并添加测试用户。
  • 创建 OAuth 客户端 ID 并下载凭证文件。
  • 将凭证文件放置在 src/main/resources 目录下。

使用教程

使用依赖

  • Java 17 或更高版本。
  • Maven。
  • Gmail API 凭证。

安装教程

  1. 克隆仓库: sh git clone <repository-url> cd <repository-directory>

  2. 配置 Gmail API 凭证:

  3. 创建 Google Cloud 项目并启用 Gmail API。
  4. 配置 OAuth 同意屏幕并添加测试用户。
  5. 创建 OAuth 客户端 ID 并下载凭证文件。
  6. 将凭证文件 credentials.json 放置在 src/main/resources 目录下。

  7. 构建项目: sh mvn clean install

调试方式

  1. 启动 MCP 服务器: sh mvn spring-boot:run

  2. 测试 ClientStdio: sh mvn clean install -DskipTests 然后运行 ClientStdio 类。

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。