Gmail MCP Server 15s

🚀 Gmail MCP 服務器

Gmail MCP 服務器是一個集成了 FastMCP（模型控制協議）的 Gmail 系統，它為 AI 助手搭建了橋樑，使其能借助一系列工具和提示與 Gmail 進行交互，極大地拓展了 Gmail 的使用場景和便捷性。

🚀 快速開始

此項目採用服務器 - 客戶端架構，讓 AI 助手能夠執行多種 Gmail 操作，如發送郵件、查看未讀郵件等。使用 OAuth 2.0 進行身份驗證，並結合 Gmail 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)

✨ 主要特性

• 集成 FastMCP 協議，為 AI 助手與 Gmail 交互提供支持。
• 支持多種 Gmail 操作，包括髮送郵件、查看未讀郵件等。
• 使用 OAuth 2.0 進行身份驗證，保障系統安全。
• 集成 LLM（如 Gemini 1.5 Flash），能理解自然語言請求並執行相應操作。

📦 安裝指南

先決條件

• 需要 Python 3.6 或更高版本。
• 安裝必要的庫：google-auth、google-api-python-client、fastmcp。

準備文件

• credentials.json：OAuth 憑證文件，由 Google 開發者控制檯生成。
• token.json：存儲 OAuth 認證後的令牌。
• .env：包含 API 密鑰和相關配置。

💻 使用示例

基礎用法

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 Server

負責 FastMCP 集成、身份驗證、郵件操作（發送、接收等）以及錯誤處理和日誌記錄。

Smart Gmail Client

使用 LLM（如 Gemini 1.5 Flash）來理解自然語言請求，提取參數並執行相應的郵件操作。

開發擴展

添加新的 Gmail 操作

1. 在 gmail_server.py 中實現新工具。
2. 系統將自動發現並暴露新功能。

自定義 LLM 提示

可以通過修改 test_gmail_server.py 中的提示詞，優化參數提取和特定請求處理。

⚠️ 安全注意事項

項目不包含憑證文件，請勿提交以下文件到版本控制系統：

• credentials.json
• token.json
• .env

這些文件已添加到 .gitignore 中以防止意外提交。

📄 參考資料

Medium 文章