Gmail MCP Server

Gmail MCP サーバー

このプロジェクトは、Gmail 用の Spring Boot MCP（Model Context Protocol）サーバーです。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 同意画面を設定する
     • 「external」を選択します。ただし、アプリは公開しません。
     • 個人のメールアドレスを「Test user」として追加します。
   • OAuth スコープ https://www.googleapis.com/auth/gmail/modify を追加します
   • アプリケーションの種類に「Desktop App」を指定して、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 ファイルを参照してください。