Quantum 369 Gmail MCP Server

🚀 Gmail MCP サーバー

Gmail MCP サーバーは、MCP（メッセージ制御プロトコル）フレームワークに基づいて構築された、強力で柔軟な Gmail 統合サーバーです。このサーバーは、Gmail API との強力なインターフェースを提供し、メールの読み取り、送信、管理をサポートします。

🚀 クイックスタート

Gmail MCP サーバーを使用することで、Gmail API とのやり取りを通じて、メールの読み取り、送信、管理を行うことができます。以下の手順に従って、サーバーをセットアップしてください。

✨ 主な機能

• 複数の Gmail アカウントからのメール読み取り
• 添付ファイル付きのメール送信
• 高度な検索オプションを備えたメール検索
• メール添付ファイルのダウンロード機能
• メール会話とスレッドの管理
• リアルタイムのメール監視
• 複数の Gmail アカウントのサポート

📦 インストール

Smithery を通じたインストール

Smithery を使用して、Gmail 統合サーバーを自動的にインストールします：

npx -y @smithery/cli install @Quantum-369/Gmail-mcp-server --client claude

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

git clone <your-repository-url>
cd gmail-mcp-server

2. 仮想環境を作成してアクティブ化します：

python -m venv venv
# Windows システム
venv\Scripts\activate
# Unix/MacOS システム
source venv/bin/activate

3. 依存関係をインストールします：

pip install .

📚 ドキュメント

Google Cloud プロジェクトの設定

1. Google Cloud Console にアクセスします。
2. 新しいプロジェクトを作成するか、既存のプロジェクトを選択します。
3. プロジェクトの Gmail API を有効にします。
4. OAuth 2.0 クレデンシャルを作成します：
   • "APIs & Services" > "Credentials" に移動します。
   • "Create Credentials" > "OAuth client ID" をクリックします。
   • アプリケーションのタイプとして "Desktop app" を選択します。
   • クライアント構成ファイルをダウンロードします。
5. ダウンロードしたファイルを client_secret.json にリネームし、プロジェクトのルートディレクトリに配置します。

設定

1. gmail_token_creator.py でメール識別子を設定します：

email_identifier = 'your.email@gmail.com'  # 必要に応じて変更

2. トークン作成ツールを実行して、Gmail アカウントを認証します：

python gmail_token_creator.py

3. 統合する各 Gmail アカウントに対して、上記の手順を繰り返します。

サーバー構造

• gmail_server.py：主要な MCP サーバーの実装
• gmail_api.py：Gmail API とのやり取りを行う関数
• google_apis.py：Google API の認証ツール
• サポートファイル：
  • read_emails.py：メール読み取り機能
  • search_emails.py：メール検索機能
  • send_emails.py：メール送信機能

💻 使用例

サーバーの起動

python gmail_server.py

利用可能なツール

基本的な使用法

メールの送信

await send_gmail(
    email_identifier="your.email@gmail.com",
    to="recipient@example.com",
    subject="Test Subject",
    body="Email body content",
    attachment_paths=["path/to/attachment"]
)

メールの検索

async def process_email(email):
    # 見つかったメールを処理する
    pass

await search_emails(
    email_identifier="your.email@gmail.com",
    query="subject:important",
    callback=process_email
)

添付ファイルのダウンロード

async def download_attachment(attachment):
    # ダウンロードした添付ファイルを処理する
    pass

await get_attachments(
    email_identifier="your.email@gmail.com",
    message_id="message-id-12345",
    attachments_callback=download_attachment
)

🔧 技術詳細

Gmail MCP サーバーを実行する前に、以下の前提条件を満たしていることを確認してください：

1. Python 3.12 以上のバージョン
2. Gmail API を有効にした Google Cloud プロジェクト
3. OAuth 2.0 クライアント ID クレデンシャル
4. 必要な Python パッケージ（pyproject.toml で指定）

📄 ライセンス

該当するライセンス情報は提供されていません。

⚠️ 重要提示

• client_secret.json ファイルの安全性を確保し、漏洩を防いでください。
• 環境変数を使用して、機密情報（メールパスワードなど）を保存してください。
• セキュリティを強化するために、OAuth トークンを定期的に更新してください。

🔗 その他のリソース

• Gmail API ドキュメント
• Python Gmail サンプルコード

以上の手順に従えば、Gmail MCP サーバーを簡単に設定し、メールと添付ファイルを管理することができます。