Gmail MCP Java Server

🚀 Gmail MCP 服務器

本項目是一個基於 Spring Boot 的 Gmail MCP（模型上下文協議）服務器，提供了與 Gmail 交互的各類工具，通過 GMailer 類實現。同時，項目包含一個客戶端 ClientStdio，用於測試 MCP 服務器的功能。

✨ 主要特性

• GMailer 工具：

  • trashEmail：可依據郵件 ID 將郵件移至垃圾箱。
  • markEmailAsRead：能根據郵件 ID 標記郵件為已讀。
  • sendEmail：可向指定收件人發送郵件。
  • getUnreadMessages：用於獲取未讀郵件。
  • readEmail：可根據郵件 ID 讀取郵件。

• ClientStdio：這是一個用於測試 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 服務器的功能。它通過標準輸入輸出與服務器交互。

首先使用以下命令構建項目：

mvn clean install -DskipTests

然後運行 ClientStdio 類。

📄 許可證

該項目根據 MIT License 授權。有關詳細信息，請參閱 LICENSE 文件。