Gmail

🚀 Gmail MCP 服務器

Gmail MCP 服務器是一個基於模型上下文協議（Model Context Protocol）的服務器，它能夠為像 Claude Desktop 這樣的 MCP 客戶端提供 Gmail 集成功能，讓用戶可以方便地在客戶端中使用 Gmail 的相關服務。

🚀 快速開始

Gmail MCP 服務器為 MCP 客戶端提供了 Gmail 集成功能。以下是快速開始使用該服務器的步驟：

1. 完成 Google Cloud 項目設置。
2. 進行服務器的安裝。
3. 配置用於 Claude Desktop。
4. 首次運行並完成授權。

✨ 主要特性

• 郵件查看：可查看 Gmail 收件箱中的最近郵件。
• 郵件搜索：支持使用 Gmail 的搜索語法搜索郵件。
• 安全認證：通過 OAuth2 進行安全的身份驗證與 Gmail API。

📦 安裝指南

1. Google Cloud 項目設置

1. 在 Google Cloud 控制檯 創建一個 Google Cloud 項目。
2. 啟用 Gmail API。
3. 創建 OAuth 2.0 憑證：
   • 應用類型：桌面應用
   • 將憑證下載為 credentials.json

2. 安裝依賴

# 創建一個 conda 環境
conda create -n mcp-gmail python=3.12
conda activate mcp-gmail

# 安裝包
cd gmail-mcp-server
pip install -e .

3. 配置用於 Claude Desktop

將以下內容添加到您的 claude_desktop_config.json 中：

{
  "mcpServers": {
    "gmail": {
      "command": "/path/to/conda/envs/mcp-gmail/bin/python",
      "args": ["-m", "gmail_mcp_server.server"],
      "env": {
        "PYTHONPATH": "/path/to/gmail-mcp-server/src",
        "GMAIL_CREDENTIALS_FILE": "/path/to/credentials.json",
        "GMAIL_TOKEN_FILE": "/path/to/token.json"
      }
    }
  }
}

請將 /path/to/ 替換為您的實際路徑。首次認證時，令牌文件會自動創建。

4. 首次運行

當您第一次嘗試通過 Claude 訪問 Gmail 時，將在瀏覽器中提示您授權應用程序。授權後，憑證將保存到令牌文件中以供以後使用。

💻 使用示例

可用資源

• gmail://inbox/recent - 返回您的 10 封最新郵件

可用工具

• search_emails
  • 描述：使用查詢搜索 Gmail 郵件
  • 參數：
    • query（必需）：Gmail 搜索查詢（使用 Gmail 的標準搜索語法）
    • max_results（可選）：要返回的結果的最大數量（默認值：10）

示例搜索：

你能展示我過去兩天內來自 sanrio 的任何郵件嗎？

📚 詳細文檔

安全說明

此服務器需要通過 OAuth2 進行身份驗證與 Gmail：

• 第一次使用時，您會在瀏覽器中被提示授權訪問。
• 憑證會本地保存在指定的令牌文件中。
• 可以隨時通過您的 Google 賬戶設置 revoke 授權。
• 僅請求對 Gmail 的讀取權限（無寫入權限）。

環境變量

• GMAIL_CREDENTIALS_FILE（必需）：Google OAuth 憑證文件的路徑。
• GMAIL_TOKEN_FILE（必需）：令牌保存位置的路徑。

為了測試，可以直接運行服務器：

GMAIL_CREDENTIALS_FILE="/path/to/credentials.json" \
GMAIL_TOKEN_FILE="/path/to/token.json" \
python -m gmail_mcp_server.server

開發說明

該服務器使用 Model Context Protocol 提供以下功能：

• 資源訪問以獲取最新郵件。
• 郵件搜索工具支持。
• 權限管理與日誌記錄。
• 可擴展的事件處理機制。

貢獻指南

如果您希望為項目做出貢獻，請遵循以下指南：

1. 創建一個分支用於您的新功能或修復。
2. 提交您的更改並添加適當的提交信息，解釋所做的修改。
3. 提交 pull request 到主要倉庫，並在問題跟蹤系統中引用相關的 issue。

請確保您的代碼符合項目的編碼規範，並通過現有的測試套件。