Gmail MCP Server 9of

🚀 Gmail MCP 服務器

一個強大且靈活的 Gmail 集成服務器，基於消息控制協議 (MCP) 框架構建。它提供了與 Gmail API 交互的強大界面，支持程序化地讀取、發送和管理電子郵件，為用戶提供高效的郵件處理體驗。

🚀 快速開始

Gmail MCP 服務器是一款強大的工具，能幫助你高效地與 Gmail API 進行交互。在使用前，請確保完成以下步驟：

1. 檢查並滿足先決條件。
2. 完成服務器的安裝與配置。
3. 啟動服務器並訪問應用。

✨ 主要特性

• 可從多個 Gmail 賬戶讀取郵件，滿足多賬戶管理需求。
• 支持發送帶附件的郵件，方便信息傳遞。
• 具備高級查詢選項，可精準搜索郵件。
• 能夠下載郵件附件，便於獲取相關資料。
• 可處理郵件對話和線程，讓郵件管理更有序。
• 支持即時監控郵件，及時掌握郵件動態。
• 支持多個 Gmail 賬戶同時使用。

📦 安裝指南

使用 Smithery 安裝

通過 Smithery 可自動安裝 Gmail 集成服務器，命令如下：

npx -y @smithery/cli install @Quantum-369/Gmail-mcp-server --client claude

手動安裝

1. 克隆倉庫：

git clone <your-repository-url>
cd gmail-mcp-server

2. 創建並激活虛擬環境：

python -m venv venv
# 在 Windows 上
venv\Scripts\activate
# 在 Unix/MacOS 上
source venv/bin/activate

3. 安裝依賴項：

pip install .

📚 詳細文檔

先決條件

在運行 Gmail MCP 服務器之前，請確保具備以下條件：

1. Python 3.12 或更高版本。
2. 啟用了 Gmail API 的 Google Cloud 項目。
3. OAuth 2.0 客戶端 ID 憑證。
4. 所需的 Python 包（指定在 pyproject.toml 中）。

設置 Google Cloud 項目

1. 訪問 Google Cloud Console。
2. 創建新項目或選擇現有項目。
3. 啟用項目的 Gmail API。
4. 創建 OAuth 2.0 憑證：
   • 轉到 "APIs & Services" > "Credentials"。
   • 點擊 "Create Credentials" > "OAuth client ID"。
   • 選擇 "Desktop app" 作為應用類型。
   • 下載客戶端配置文件。
5. 將下載的文件重命名為 client_secret.json 並放在項目根目錄中。

配置

1. 在 gmail_token_creator.py 中設置電子郵件標識符：

email_identifier = 'your.email@gmail.com'  # 根據每個賬戶修改此值

2. 運行令牌創建工具以身份驗證您的 Gmail 賬戶：

python gmail_token_creator.py

3. 對於要集成的每個 Gmail 賬戶，重複上述步驟。

服務器結構

• gmail_server.py：核心服務器文件。
• settings.py：配置和設置。
• templates/：HTML 模板目錄。
• static/：靜態資源目錄。

使用方法

安裝依賴項

使用 pip 安裝所需的 Python 包：

pip install -r requirements.txt

啟動服務器

運行以下命令啟動 Gmail MCP 服務器：

python gmail_server.py

訪問應用

打開瀏覽器訪問 http://localhost:8000。

安全注意事項

⚠️ 重要提示

• 將所有敏感文件（如 client_secret.json）加密並存儲在安全位置。
• 避免將憑證提交到版本控制系統中，可以將其加入 .gitignore 文件。
• 使用環境變量來管理敏感信息，而不是硬編碼在代碼中。

錯誤處理

日誌記錄

服務器使用日誌文件記錄操作狀態和錯誤信息。默認情況下，日誌文件位於 logs/ 目錄中。

調試

檢查 settings.py 中的日誌級別設置，以調整輸出的詳細程度。

貢獻指南

克隆倉庫

git clone https://github.com/yourusername/gmail-mcp-server.git

提交更改

1. 創建功能分支：

git checkout -b feature/new-feature

2. 提交更改：

git add .
git commit -m "添加新功能"

3. 推送到原點並創建拉取請求：

git push origin feature/new-feature

📄 許可證

此項目受 MIT License 保護。

📞 聯繫方式

有問題或建議？請發送郵件到 contact@example.com 或在 GitHub 上提交問題。