Gongrzhe Gmail MCP Server

🚀 Gmail 自動身份驗證 MCP 服務器

本項目是一個用於 Gmail 集成的 Claude 桌面版的 Model Context Protocol (MCP) 服務器，支持自動身份驗證功能。藉助此服務器，AI 助手能夠通過自然語言交互管理 Gmail，為用戶提供便捷的郵件管理體驗。

🚀 快速開始

本服務器可助力 AI 助手通過自然語言交互管理 Gmail。你可依據以下步驟完成安裝與配置，開啟使用之旅。

✨ 主要特性

• 📧 發送帶有主題、內容、附件和收件人的電子郵件。
• 👀 通過 ID 閱讀電子郵件消息。
• 🔍 使用各種標準（主題、發件人、日期範圍）搜索電子郵件。
• 📋 在收件箱、已發送或自定義標籤中列出電子郵件。
• ✔️ 標記電子郵件為已讀/未讀。
• 📁 將電子郵件移動到不同的標籤/文件夾。
• 🟢 與 Gmail API 完全集成。
• 🔐 簡單的 OAuth2 身份驗證流程，支持自動瀏覽器啟動。
• 💻 支持桌面版和網絡版。
• 🔒 在本地安全存儲憑據。

📦 安裝指南

使用 Smithery CLI 安裝

smith install @gongrzhe/server-gmail-autoauth-mcp

手動安裝

1. 克隆此倉庫：

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

2. 安裝依賴項：

   npm install
   

3. 啟動服務器：

   node index.js
   

💻 使用示例

基礎用法

配置 Gmail 憑據

在 config.json 文件中添加以下內容：

{
  "gmail": {
    "clientId": "your_client_id",
    "clientSecret": "your_client_secret",
    "redirectUri": "http://localhost:3000"
  }
}

授權 Gmail 帳戶

運行以下命令以授權您的 Gmail 帳戶：

node authorize.js

按照提示完成 OAuth 流程。

高級用法

發送電子郵件

{
  "to": ["recipient@example.com"],
  "subject": "Meeting Tomorrow",
  "body": "Hi,\n\nJust a reminder about our meeting tomorrow at 10 AM.\n\nBest regards",
  "cc": ["cc@example.com"],
  "bcc": ["bcc@example.com"]
}

搜索電子郵件

{
  "query": "from:sender@example.com after:2024/01/01",
  "maxResults": 10
}

閱讀電子郵件

{
  "messageId": "message123"
}

移動電子郵件

{
  "messageId": "message123",
  "labelIds": ["INBOX", "IMPORTANT"]
}

📚 詳細文檔

安全注意事項

• ⚠️ OAuth 憑據安全存儲在本地環境 (~/.gmail-mcp)。
• 🔒 服務器使用離線訪問來保持持久身份驗證。
• 🚫 絕對不要共享或提交您的憑據到版本控制。
• 🔄 定期檢查並吊銷未使用的 Google 賬戶權限。
• 👤 憑據在全球範圍內存儲，但僅限當前用戶訪問。

故障排除

1. OAuth Keys 未找到
   • 確保 gcp-oauth.keys.json 在當前目錄或 ~/.gmail-mcp/ 中。
   • 檢查文件權限。
2. 無效憑據格式
   • 確保您的 OAuth 憑據文件包含 web 或 installed 憑據。
   • 對於網絡應用，請驗證重定向 URI 正確配置。
3. 端口已被佔用
   • 如果端口 3000 已被佔用，請釋放它。
   • 您可以找到並停止使用該端口的進程。

貢獻

歡迎貢獻！請隨時提交 Pull Request。

支持

如果您遇到任何問題或有任何疑問，請在 GitHub 倉庫中提交問題。

📄 許可證

本項目根據 ISC 許可證發佈。