Headless Gmail

🚀 ヘッドレス Gmail MCP サーバー

MCP ヘッドレス Gmail サーバーは、Google API をベースにしたサービスです。コマンドラインやその他の自動化ツールを通じて、Gmail アカウントとのやり取りを可能にします。メールの読み取り、メール本文の取得、新しいメールの送信などの機能をサポートしています。

🚀 クイックスタート

MCP ヘッドレス Gmail サーバーは、Google API を利用して、コマンドラインや自動化ツールから Gmail アカウントとのやり取りを可能にするサービスです。

✨ 主な機能

1. 完全自動化：手動操作を必要とせず、スクリプトやコマンドラインからの呼び出しが可能です。
2. 高いパフォーマンス：API 呼び出しのプロセスが最適化されており、大量のメールを処理する際にも効率的です。
3. セキュアな設計：トークン認証方式を採用し、OAuth 2.0 プロトコルをサポートして、データ転送の安全性を確保します。
4. 拡張性に優れる：他のシステムとの統合が容易で、Gmail 関連の機能を迅速に追加することができます。

機能の詳細

• メールの読み取り：受信トレイのメールリスト、メール内容、詳細情報を取得します。
• メール本文の取得：大きなサイズのメールの本文内容をブロック単位で読み取ることができます。
• メールの送信：API を通じて新しいメールを送信し、HTML 形式と純テキスト形式をサポートします。

📦 インストール

前提条件

1. Google Cloud アカウントを登録し、プロジェクトを作成します。
2. Gmail API を有効にします。
3. OAuth 整合性画面を設定します。
4. OAuth クライアント ID を作成します（デスクトップアプリケーションタイプを選択）。
5. アクセストークンとリフレッシュトークンを取得します。必要なスコープは以下の通りです。
   • https://www.googleapis.com/auth/gmail.readonly（メールの読み取り用）
   • https://www.googleapis.com/auth/gmail.send（メールの送信用）

インストール手順

1. リポジトリをクローンします。

   git clone https://github.com/yourusername/mcp-headless-gmail.git
   cd mcp-headless-gmail
   

2. 依存関係をインストールします。

   pip install -r requirements.txt
   

3. 環境変数を設定し、Google API の認証情報を設定します。

   export GOOGLE_CLIENT_ID=your_client_id
   export GOOGLE_CLIENT_SECRET=your_client_secret
   export GOOGLE_REFRESH_TOKEN=your_refresh_token
   

4. サービスを起動します。

   python3 server.py
   

💻 使用例

Docker を使用する場合

イメージのビルド

# ベースイメージ
FROM python:3.8-slim

# 作業ディレクトリを設定
WORKDIR /app

# 依存関係をインストール
COPY requirements.txt .
RUN pip install -r requirements.txt

# アプリケーションコードをコピー
COPY . .

# 環境変数を設定
ENV GOOGLE_CLIENT_ID=your_client_id \
    GOOGLE_CLIENT_SECRET=your_client_secret \
    GOOGLE_REFRESH_TOKEN=your_refresh_token

# 起動コマンド
CMD ["python3", "server.py"]

コンテナの実行

docker build -t mcp-headless-gmail .
docker run -d --name mcp-email-service mcp-headless-gmail

Claude Desktop の設定

1. Claude.yaml に以下のツールを追加します。

   tools:
     - name: gmail_get_recent_emails
       path: /api/gmail/recent
     - name: gmail_get_email_body
       path: /api/gmail/body
     - name: gmail_send_email
       path: /api/gmail/send
     - name: gmail_refresh_token
       path: /api/gmail/refresh-token
   

2. Claude でこれらのツールを使用します。

   {
     "tool": "gmail_get_recent_emails",
     "args": {
       "access_token": "${GOOGLE_ACCESS_TOKEN}"
     }
   }
   

クロスプラットフォームでの公開

1. マルチプラットフォームのイメージを生成します。

   docker buildx build --platform linux/amd64,linux/arm64 -t mcp-headless-gmail:multi .
   

2. イメージを Docker Hub や他のレジストリにプッシュします。

🔧 技術詳細

セキュリティに関する注意事項

• 常に HTTPS を使用してデータを転送します。
• 認証情報を公開コードリポジトリにコミットしないでください。
• 定期的にアクセストークンを更新して、セキュリティを確保します。

📄 ライセンス

詳細は LICENSE ファイルを参照してください。