Gmail MCP Server

🚀 Gmail-MCP-Server

このプロジェクトは、fastMCP を用いて構築された弾力性のある MCP サーバーです。Gmail の SMTP サーバーを通じて電子メールを送信し、AI エージェントを利用してファイル添付を処理します。

🚀 クイックスタート

このサーバーは、fastMCP を使用して構築された弾力性のある MCP 実装です。Gmail の SMTP サーバーを通じて電子メールを送信し、以下の方法でファイルを添付できます。

• 直接ファイルパス: ローカルファイルシステムに存在するファイルを添付します。
• URL ベースの添付: 指定された URL からファイルをダウンロードして添付します。
• 事前保存添付: 特定のディレクトリに保存された添付ファイルを使用します。

このサーバーは弾力性を重視して設計されており、タイムアウト設定の追加とエレガントなシャットダウン処理が備わっています。

✨ 主な機能

• Gmail SMTP 統合: Gmail の SMTP サーバーを使用して、TLS を通じて電子メールを送信します。（Gmail アカウントで SMTP を設定し、アプリケーションパスワードを生成してください）
• 複数の添付方法:
  • ファイルパスから直接添付します。
  • パブリック URL からファイルをダウンロードして処理します。
  • 事前保存されたローカルストレージの添付ファイルを使用します。
• 弾力性のある設計: タイムアウト設定の追加とシグナル処理により、エレガントなシャットダウンを実現します。
• 環境変数による設定: 環境変数を使用して、Gmail の資格情報を安全に管理します。

📦 インストール

前提条件

• Python 3.x
• fastMCP（pip install mcp でインストール）
• python-dotenv（pip install python-dotenv でインストール）
• requests（pip install requests でインストール）

設定手順

1. リポジトリをクローン:

git clone <リモートリポジトリ URL>
cd gmail-mcp-server

2. 環境変数を設定: ルートディレクトリに .env ファイルを作成し、Gmail の SMTP 資格情報を追加します。

SMTP_USERNAME=your.email@gmail.com 
SMTP_PASSWORD=your_app_password

注意: Gmail アカウントで二段階認証を有効にしている場合は、アプリケーションパスワードを生成して使用する必要があります。

OPEN CLAUDE > 設定 > MCP > 構成 > OPEN claude_desktop_config.json > 以下のパスにファイルを貼り付けます。

{
  "mcpServers": {
    "gmail-mcp": {
      "command": "python",
      "args": ["PATH_TO_gmail-mcp.py"],
      "port": 5005
    }
  }
}

PATH_TO_gmail-mcp.py を実際のスクリプトパスに置き換えてください。

インストール手順

fastMCP を pip でインストールします。

pip install mcp

サーバーを起動します。

python your_script_name.py

💻 使用例

基本的な使用法

1. 直接ファイル添付

Python スクリプトで、ファイルパスから直接添付します。

from mcp import Client

client = Client('localhost', 5005)
client.send_email_with_attachment('to@example.com', '件名', '本文', '/path/to/file.txt')

2. URL ベースの添付

指定された URL からファイルをダウンロードして添付します。

from mcp import Client

client = Client('localhost', 5005)
client.send_email_with_url_attachment('to@example.com', '件名', '本文', 'http://example.com/file.txt')

3. 事前保存添付

事前保存された添付ファイルを使用して処理します。

from mcp import Client

client = Client('localhost', 5005)
client.send_email_with_pre_attached_file('to@example.com', '件名', '本文', '/path/to/pre_attachment.txt')