Gmail MCP Server Njw

🚀 Gmail MCP サーバー

この MCP サーバーは、Model Context Protocol を通じて Gmail 機能へのアクセスを提供し、Claude などの大規模言語モデルがあなたの電子メールとやり取りできるようにします。

✨ 主な機能

• 受信トレイのメールを一覧表示する
• 特定のメールを検索する
• メール内容を表示する
• 新しいメールを送信する
• 既存のメールに返信する

📦 インストール

依存関係のインストール

python -m venv venv
source venv/bin/activate  # Windowsの場合：venv\Scripts\activate
pip install -r requirements.txt

Google API の認証情報の設定

1. Google Cloud Console にアクセスします。
2. 新しいプロジェクトを作成します。
3. Gmail API を有効にします。
   • サイドバーで、「APIs & Services」>「Library」に移動します。
   • 「Gmail API」を検索して選択します。
   • 「Enable」をクリックします。
4. OAuth 2.0 の認証情報を作成します。
   • サイドバーで、「APIs & Services」>「Credentials」に移動します。
   • 「Create Credentials」をクリックし、「OAuth client ID」を選択します。
   • アプリケーションの種類として「Desktop application」を選択します。
   • OAuth クライアントに名前（例：「Gmail MCP Server」）を入力します。
   • 「Create」をクリックします。
   • 認証情報の JSON ファイルをダウンロードし、プロジェクトのルートディレクトリに credentials.json として保存します。

.env ファイルの作成

cp .env.example .env

サーバーの起動

• サーバーを初めて起動すると、認証用のブラウザウィンドウが開きます。
• 指示に従って承認プロセスを完了し、アプリケーションがあなたの Gmail アカウントにアクセスできるようにします。

📚 ドキュメント

Gmail API の詳細設定

認証情報ファイルの理解

credentials.json

• このファイルには、Google Cloud から取得した OAuth 2.0 クライアントの認証情報が含まれています。
• Google の OAuth サーバーにあなたのアプリケーションを識別するために使用されます。
• 形式の例（値はあなたのアプリケーションによって異なります）：

{
  "installed": {
    "client_id": "YOUR_CLIENT_ID.apps.googleusercontent.com",
    "project_id": "your-project-id",
    "auth_uri": "https://accounts.google.com/o/oauth2/auth",
    "token_uri": "https://oauth2.googleapis.com/token",
    "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
    "client_secret": "YOUR_CLIENT_SECRET",
    "redirect_uris": ["http://localhost"]
  }
}

• 提供されている credentials.json.example を参考にすることができます。

token.json

• このファイルは初回認証時に自動的に生成されます。
• Gmail アカウントにアクセスするために必要な OAuth トークンが含まれています。
• ブラウザでの認証プロセスを完了した後に作成されます。
• 形式の例（トークンはあなたのアカウントによって異なります）：

{
  "token": "ya29.a0AfB_byC...",
  "refresh_token": "1//0eXxYz...",
  "token_uri": "https://oauth2.googleapis.com/token",
  "client_id": "YOUR_CLIENT_ID.apps.googleusercontent.com",
  "client_secret": "YOUR_CLIENT_SECRET",
  "refresh_token": "1//0eXxYz...",
  "expiry_time": "2023-10-25T12:36:48.000Z"
}

🔧 技術詳細

このプロジェクトは、シンプルで効率的な設計理念に従っています。

1. コードを最小限に抑え、冗長性を排除する。
2. Gmail API を直接統合する。
3. 模擬データや不要な抽象化を使用しない。
4. 信頼性とパフォーマンスに重点を置く。