Gmail MCP Server 15s

🚀 Gmail MCP サーバ

Gmail MCP サーバは、FastMCP（モデル制御プロトコル）を統合した Gmail システムです。これにより、AI アシスタントは一連のツールとプロンプトを通じて Gmail と対話することができます。

🚀 クイックスタート

このプロジェクトは、AI アシスタントが Gmail で以下の操作を実行できるサーバ - クライアントアーキテクチャを提供します。

• メールの送信
• 未読メールの確認
• メール内容の閲覧
• メールをゴミ箱に移動
• ブラウザでメールを開く
• メールを既読にする

これらの機能は、OAuth 2.0 による認証と Gmail API を組み合わせて実現されています。

✨ 主な機能

• Gmail Server：FastMCP の統合、認証、メール操作（送信、受信など）、エラー処理とログ記録を担当します。
• Smart Gmail Client：LLM（Gemini 1.5 Flash など）を使用して自然言語のリクエストを理解し、パラメータを抽出して対応するメール操作を実行します。

📦 インストール

前提条件

• Python 3.6 以上のバージョン
• 必要なライブラリのインストール：google-auth, google-api-python-client, fastmcp

準備するファイル

• credentials.json：Google 開発者コンソールで生成される OAuth 認証情報ファイル。
• token.json：OAuth 認証後のトークンを保存するファイル。
• .env：API キーと関連する設定を含むファイル。

💻 使用例

基本的な使用法

サーバの起動

python3 gmail_server.py

クライアントの使用

from gmail_client import GmailClient
client = GmailClient()
result = client.send_email(to="recipient@example.com", subject="Test", message="Hello World!")
print(result)

🔧 技術詳細

メール内容の処理

MIME メッセージの解析、マルチパートメールと添付ファイルの処理をサポートし、メールヘッダーと本文を正しくデコードします。

LLM の統合

Gemini 1.5 Flash を使用して、自然言語のリクエストを構造化されたツール呼び出しに変換し、フォールバックメカニズムで不適切な応答を処理します。

📚 ドキュメント

開発拡張

新しい Gmail 操作を追加するには、以下の手順を実行します。

1. gmail_server.py で新しいツールを実装します。
2. システムが自動的に新機能を検出して公開します。

カスタム LLM プロンプト

test_gmail_server.py のプロンプトを変更することで、パラメータの抽出と特定のリクエストの処理を最適化できます。

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

• このプロジェクトには認証情報ファイルは含まれていません。以下のファイルをバージョン管理システムにコミットしないでください。
  • credentials.json
  • token.json
  • .env

これらのファイルは、誤ってコミットされないように .gitignore に追加されています。

📄 参考資料

Medium 記事