
Gmail MCP Server

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 凭证。
安装教程
-
克隆仓库:
sh git clone <repository-url> cd <repository-directory>
-
配置 Gmail API 凭证:
- 创建 Google Cloud 项目并启用 Gmail API。
- 配置 OAuth 同意屏幕并添加测试用户。
- 创建 OAuth 客户端 ID 并下载凭证文件。
-
将凭证文件
credentials.json
放置在src/main/resources
目录下。 -
构建项目:
sh mvn clean install
调试方式
-
启动 MCP 服务器:
sh mvn spring-boot:run
-
测试 ClientStdio:
sh mvn clean install -DskipTests
然后运行ClientStdio
类。