Gmail MCP Server Njw

🚀 Gmail MCP 服務器

這個 MCP 服務器藉助 Model Context Protocol 提供對 Gmail 功能的訪問，允許像 Claude 這樣的大語言模型與您的電子郵件進行交互，為大語言模型與郵件系統的交互提供了便捷途徑。

✨ 主要特性

• 列出收件箱中的郵件
• 搜索特定郵件
• 查看郵件內容
• 發送新郵件
• 回覆現有郵件

📦 安裝指南

1. 安裝依賴項：

   python -m venv venv
   source venv/bin/activate  # 在 Windows 上：venv\Scripts\activate
   pip install -r requirements.txt
   

2. 設置 Google API 憑據：
   • 訪問 Google Cloud Console
   • 創建新項目
   • 啟用 Gmail API：
     • 在側邊欄中，導航到 "APIs & Services" > "Library"
     • 搜索 "Gmail API" 並選擇它
     • 點擊 "Enable"
   • 創建 OAuth 2.0 憑據：
     • 在側邊欄中，導航到 "APIs & Services" > "Credentials"
     • 點擊 "Create Credentials" 並選擇 "OAuth client ID"
     • 選擇 "Desktop application" 作為應用類型
     • 輸入一個名稱為您的 OAuth 客戶（例如，"Gmail MCP Server"）
     • 點擊 "Create"
     • 下載憑據 JSON 文件並將其保存為 credentials.json 在項目根目錄中
3. 複製示例創建 .env 文件：

   cp .env.example .env
   

4. 運行服務器：
   • 第一次運行服務器時，它會打開一個瀏覽器窗口進行身份驗證
   • 跟隨提示完成授權流程以允許應用程序訪問您的 Gmail 帳戶

📚 詳細文檔

詳細 Gmail API 設置

理解憑據文件

1. credentials.json：
   • 此文件包含您從 Google Cloud 獲取的 OAuth 2.0 客戶端憑據
   • 用於標識您的應用到 Google 的 OAuth 服務器
   • 格式示例（值將根據您的應用程序不同）：

     {
       "installed": {
         "client_id": "YOUR_CLIENT_ID.apps.googleusercontent.com",
         "project_id": "your-project-id",
         "auth_uri": "https://accounts.google.com/o/oauth2/auth",
         "token_uri": "https://oauth2.googleapis.com/token",
         "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
         "client_secret": "YOUR_CLIENT_SECRET",
         "redirect_uris": ["http://localhost"]
       }
     }
     

   • 您可以使用提供的 credentials.json.example 作為參考
2. token.json：
   • 此文件在第一次身份驗證時自動生成
   • 它包含訪問您的 Gmail 帳戶所需的 OAuth 令牌
   • 文件在您完成瀏覽器中的身份驗證流程後創建
   • 格式示例（令牌將根據您的帳戶不同）：

     {
       "token": "ya29.a0AfB_byC...",
       "refresh_token": "1//0eXxYz...",
       "token_uri": "https://oauth2.googleapis.com/token",
       "client_id": "YOUR_CLIENT_ID.apps.googleusercontent.com",
       "client_secret": "YOUR_CLIENT_SECRET",
       "refresh_token": "1//0eXxYz...",
       "expiry_time": "2023-10-25T12:36:48.000Z"
     }
     

🔧 技術細節

這個項目遵循簡潔、高效的設計理念：

1. 最小化代碼，無冗餘
2. 直接集成 Gmail API
3. 無模擬數據或不必要的抽象
4. 關注可靠性和性能