Gmail Attachment MCP Server

🚀 Gmail 添付ファイル MCP サーバー

このサーバーは、メッセージ制御プロトコル (MCP) を通じて Gmail の添付ファイルをダウンロードするためのマイクロサービスを提供します。

🚀 クイックスタート

このプロジェクトは FastMCP サーバーを実装しており、メッセージ ID を使用して Gmail メッセージの添付ファイルをダウンロードできます。IMAP を使用して Gmail に接続し、添付ファイルを取得します。

✨ 主な機能

• メッセージ ID を使用して Gmail メッセージの添付ファイルをダウンロードする
• SSL を使用した Gmail の IMAP への安全な接続
• 環境変数で認証資格情報を設定する
• MCP で提供されるシンプルな API インターフェース

📦 インストール

前提条件

• Python 3.7 以上
• uv がインストールされていること
• IMAP が有効な Gmail アカウント
• 二段階認証を使用している場合は、Gmail アプリパスワードが必要

インストール手順

# リポジトリをクローンする
git clone https://github.com/yourusername/gmail-attachment-mcp-server.git
cd gmail-attachment-mcp-server

# 依存関係をインストールする
uv 同步

📚 ドキュメント

設定

以下の環境変数を設定してください。

export GMAIL_USERNAME="your.email@gmail.com"
export GMAIL_PASSWORD="your_app_password"
export GMAIL_IMAP_SERVER="imap.gmail.com" # オプション、デフォルトは imap.gmail.com

⚠️ 重要提示

Gmail の場合は、通常のパスワードではなくアプリパスワードを使用する必要があります。詳細については Google のドキュメント を参照してください。

使用方法

サーバーの起動

python server.py
# または
mcp 运行 server.py

ツールの使用

このサーバーは download_attachments_tool を公開しており、以下のパラメータを受け付けます。

• message_id: Gmail メッセージ ID、16 進数形式
• download_folder: (オプション) ダウンロード先のフォルダパス（デフォルトは "./attachments"）

この関数は、ダウンロードした添付ファイルのファイルパスを含む文字列のリストを返します。

mcp チェックツールの使用

npx @modelcontextprotocol/inspector uv 运行 mcp 运行 server.py

鹅 (geese) の使用

extensions:
  gmail-attachment-mcp-server:
    args:
      - run
      - /path to virtual env/.venv/bin/mcp
      - run
      - /path to gmail-attachment-mcp-server/server.py
    bundled: null
    cmd: uv
    description: null
    enabled: true
    env_keys:
      - GMAIL_USERNAME
      - GMAIL_PASSWORD
    envs: {}
    name: gmail-attachment-mcp-server
    timeout: 300
    type: stdio

📄 API ドキュメント

download_attachments_tool

download_attachments_tool(message_id: str, download_folder="./attachments") -> list[str]

Gmail メッセージから添付ファイルをダウンロードします。メッセージはメッセージ ID で識別されます。

パラメータ

• message_id: Gmail メッセージ ID、16 進数形式
• download_folder: (オプション) ダウンロード先のフォルダパス（デフォルトは "./attachments"）

戻り値

• ダウンロードした添付ファイルのファイルパスを含む文字列のリスト