Gmail MCP Java Server

🚀 Gmail MCP サーバー

このプロジェクトは、Spring Boot ベースの Gmail MCP（モデルコンテキストプロトコル）サーバーです。GMailer クラスを通じて、Gmail とのやり取りに必要な様々なツールを提供します。また、MCP サーバーの機能をテストするためのクライアント ClientStdio も含まれています。

✨ 主な機能

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 ファイルを参照してください。