MCP Server V4 Gmail

🚀 MCP 服務器套件：計算器 + Gmail 集成

本套件是一款強大的模型上下文協議（MCP）服務器套件，它結合了高級計算器和 Gmail 集成功能。藉助該套件，您能夠執行復雜的數學計算，並通過 Claude Desktop MCP 客戶端將計算結果通過電子郵件發送出去。

✨ 主要特性

高級計算器

• 📱 支持複雜的 BODMAS（括號、順序、除法、乘法、加法、減法）運算。
• 🧮 具備多種高級數學函數：
  • 三角函數（sin, cos, tan）
  • 指數和對數運算
  • 平方根和立方根
  • 階乘計算
  • 斐波那契數列生成
• ✅ 可進行分步推理驗證。
• 📊 能開展計算一致性檢查。

Gmail 集成

• 📧 可通過電子郵件發送計算結果。
• 📥 能夠檢查和讀取未讀郵件。
• 🗑️ 支持管理郵件（標記為已讀，移到垃圾箱）。
• 🌐 能在瀏覽器中打開郵件。

🏗️ 項目結構

MCP-Server-V4-Gmail/
├── calculator-mcp-server/       # 計算器 MCP 服務器
│   ├── math-mcp-server/
│   │   ├── mcp_server.py       # 計算器實現
│   │   └── models.py           # 數據模型
│   ├── pyproject.toml
│   └── README.md
└── gmail-mcp-server/           # Gmail MCP 服務器
    ├── src/
    │   └── gmail/
    │       ├── server.py       # Gmail 集成
    │       └── __init__.py
    ├── pyproject.toml
    └── README.md

📦 安裝指南

先決條件

• Python 3.12 或更高版本。
• Claude Desktop MCP 客戶端。
• Google Cloud Platform 賬戶（用於 Gmail API）。

1. Gmail API 設置

1. 創建一個新的 Google Cloud 項目。
2. 啟用 Gmail API。
3. 配置 OAuth 同意屏幕：
   • 選擇“外部”（無需發佈）。
   • 添加您的電子郵件作為“測試用戶”。
4. 添加 OAuth 範圍：https://www.googleapis.com/auth/gmail/modify。
5. 創建桌面應用的 OAuth 客戶端 ID。
6. 下載並保存 OAuth 憑證 JSON 文件。

2. 服務器安裝

# 克隆倉庫
cd MCP-Server-V4-Gmail

# 設置計算器服務器
cd calculator-mcp-server
uv venv
uv pip install -r requirements.txt

# 設置Gmail服務器
cd ../gmail-mcp-server
uv venv
uv pip install -r requirements.txt

3. Claude Desktop 配置

將兩個服務器添加到 Claude Desktop 配置中：

{
    "calculator_server": {
        "host": "localhost",
        "port": 5000
    },
    "gmail_integration": {
        "enabled": true,
        "api_key": "your_api_key"
    }
}

💻 使用示例

啟動服務器

# 計算器服務器
python calculator-mcp-server/mcp_server.py

# Gmail 服務器
python gmail-mcp-server/src/gmail/server.py

在Claude中使用

1. 啟動計算器並執行計算：

python calculator-mcp-server/mcp_server.py

2. 使用 Gmail API 發送結果：

python gmail-mcp-server/src/gmail/server.py

示例工作流程

1. 啟動計算器服務器：python calculator-mcp-server/mcp_server.py
2. 啟動 Gmail 服務器：python gmail-mcp-server/src/gmail/server.py

🔧 技術細節

安全

• Gmail API 使用 OAuth 2.0 進行身份驗證。
• 令牌安全地存儲在指定位置。
• 郵件操作需要用戶明確確認。

📄 許可證

本項目採用 MIT License 許可協議。

👥 作者

• 計算器服務器由 Saish Shetty 開發。
• Gmail 集成由原始作者開發。