Gmail MCP Server

🚀 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 賬戶上啟用了兩步驗證，必須生成並使用應用程序密碼。

3. OPEN CLAUDE 配置 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 替換為實際的腳本路徑。

4. 使用 pip 安裝 fastMCP

pip install mcp

5. 運行服務器

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')