关于 Gmail MCP Server
Gmail MCP Server 是面向希望通过 MCP 操作 Gmail 的 Java 开发者的 Spring Boot 服务。它提供读取和发送邮件、标记已读及移至垃圾箱等工具，并附带 stdio 客户端用于测试。
主要功能
- 01读取邮件和未读邮件
- 02发送邮件
- 03将邮件标记为已读
- 04将邮件移至垃圾箱
- 05提供 stdio 测试客户端
适用场景
- 01通过 MCP 查看未读邮件内容
- 02向指定收件人发送邮件
- 03处理邮件时标记已读或移至垃圾箱
MCP 相关
该 Spring Boot MCP 服务通过 GMailer 工具开放 Gmail 邮件操作。项目还包含使用标准输入输出与服务交互的 ClientStdio 测试客户端。
配置
本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。
暂未收录安装方式
我们还没有获取到这个服务的安装包或远程地址，请按项目 README 中的说明安装。
工具
还没有获取到工具列表
本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。
详细介绍
Gmail MCP 服务
此项目是一个用于 Gmail 的 Spring Boot MCP（Model Context Protocol）服务。它通过 GMailer 类提供多种与 Gmail 交互的工具。此外，项目还包含一个客户端 ClientStdio，用于测试 MCP 服务的功能。
功能
-
GMailer 工具：
trashEmail：根据邮件 ID 将邮件移至垃圾箱。markEmailAsRead：根据邮件 ID 将邮件标记为已读。sendEmail：向指定收件人发送邮件。getUnreadMessages：获取未读邮件。readEmail：根据邮件 ID 读取邮件。
-
ClientStdio：使用标准输入/输出测试 MCP 服务功能的客户端。
前置条件
- Java 17 或更高版本
- Maven
- Gmail API 凭据
设置
-
克隆代码库：
git clone <repository-url> cd <repository-directory> -
配置 Gmail API 凭据：
- 创建一个新的 Google Cloud 项目
- 启用 Gmail API
- 配置 OAuth 同意屏幕
- 选择“external”。不过，我们不会发布此应用。
- 将你的个人电子邮件地址添加为“Test user”。
- 添加 OAuth 范围
https://www.googleapis.com/auth/gmail/modify - 为应用类型“Desktop App”创建 OAuth Client ID
- 下载客户端 OAuth 密钥的 JSON 文件
- 将密钥文件重命名为
credentials.json，并将其保存到本地安全位置。记下保存位置。 - 将
credentials.json文件放入src/main/resources目录。
-
构建项目：
mvn clean install
运行 MCP 服务
要启动 MCP 服务，请运行以下命令：
mvn spring-boot:run
使用 ClientStdio 测试
可以使用 ClientStdio 类测试 MCP 服务功能。它通过标准输入/输出与服务交互。
首先使用以下命令构建项目：
mvn clean install -DskipTests
然后运行 ClientStdio 类。
许可证
此项目采用 MIT 许可证。详情请参阅 LICENSE 文件。
评论
支持 Markdown
一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。