MCP Server Gmail Plugin For Claude Desktop

🚀 Gmail 插件 MCP 服務器

這是一個強大的 MCP 服務器，支持與 Gmail 集成。藉助它，你能通過 MCP 客戶端直接管理電子郵件，無縫訪問 Gmail 的核心功能，如閱讀、發送和管理郵件等。

💡 參考：查看 這個示例 瞭解使用 uvx 的 MCP 服務器實現示例。

🚀 快速開始

先決條件

• Python 3.12 或更高版本
• Gmail API 憑證
• MCP 客戶端（如 Claude Desktop）

安裝

1. 克隆倉庫：

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

2. 安裝依賴項（選擇一種方法）：

# 方法 1: 在編輯模式下安裝
uv pip install -e .

# 方法 2: 使用 requirements.txt 安裝
uv pip install -r requirements.txt

# 方法 3: 推薦使用 uv sync
uv sync --dev --all-extras

3. 配置 Gmail API 憑證：
   • 訪問 Google Cloud Console
   • 創建新項目或選擇現有項目
   • 啟用 Gmail API
   • 配置 OAuth 一致性屏幕：
     • 選擇“外部”用戶類型（無需發佈）
     • 轉到受眾群體標籤：添加您的電子郵件作為“測試用戶”
     • 添加 OAuth 作用域：https://www.googleapis.com/auth/gmail/modify
   • 創建 OAuth 2.0 憑證：
     • 選擇“桌面應用”作為應用程序類型
     • 下載 JSON 憑證文件
   • 保存憑證文件並記下其絕對路徑（將用於 --creds-file-path）

配置

開發/未發佈的服務器

在您的 MCP 客戶端配置中添加以下內容：

# 方法 1: 在編輯模式下安裝
uv pip install -e .

# 方法 2: 使用 requirements.txt 安裝
uv pip install -r requirements.txt

# 方法 3: 推薦使用 uv sync
uv sync --dev --all-extras

發佈的服務器

在 app.py 中添加以下內容：

if __name__ == "__main__":
    app.run(debug=True)

✨ 主要特性

• 📧 發送和接收電子郵件
• 📥 閱讀未讀消息
• 🗑️ 刪除電子郵件
• 📱 在瀏覽器中打開電子郵件
• 📝 標記電子郵件為已讀
• 🔒 使用 OAuth2 進行身份驗證

🎥 演示

演示鏈接

📦 安裝指南

克隆倉庫

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

安裝依賴

# 方法 1: 在編輯模式下安裝
uv pip install -e .

# 方法 2: 使用 requirements.txt 安裝
uv pip install -r requirements.txt

# 方法 3: 推薦使用 uv sync
uv sync --dev --all-extras

配置憑證

• 訪問 Google Cloud Console
• 創建新項目或選擇現有項目
• 啟用 Gmail API
• 配置 OAuth 一致性屏幕：
  • 選擇“外部”用戶類型（無需發佈）
  • 轉到受眾群體標籤：添加您的電子郵件作為“測試用戶”
  • 添加 OAuth 作用域：https://www.googleapis.com/auth/gmail/modify
• 創建 OAuth 2.0 憑證：
  • 選擇“桌面應用”作為應用程序類型
  • 下載 JSON 憑證文件
• 保存憑證文件並記下其絕對路徑（將用於 --creds-file-path）

💻 使用示例

基礎用法

在 app.py 中：

@app.route('/')
def home():
    return "歡迎使用 Gmail 插件 MCP 服務器！"

📚 詳細文檔

API 參考

工具

🤝 貢獻

1. fork 項目倉庫。
2. 創建功能分支：git checkout -b feature/your-feature
3. 提交更改：git commit -m '添加新功能'
4. 推送到 fork：git push origin feature/your-feature
5. 創建拉取請求。

📄 許可證

本項目受 MIT License 保護。