MCP Server Suite: Calculator + Gmail Integration

MCP 服务套件：计算器 + Gmail 集成

一套功能强大的模型上下文协议（MCP）服务套件，将高级计算器与 Gmail 集成相结合，让你能够执行复杂的数学计算，并通过 Claude Desktop MCP 客户端发送结果。

🌟 功能

高级计算器

• 📱 复杂的 BODMAS（括号、乘方、除法、乘法、加法、减法）运算
• 🧮 高级数学函数：
  • 三角函数（sin、cos、tan）
  • 指数和对数运算
  • 平方根和立方根
  • 阶乘计算
  • 生成斐波那契数列
• ✅ 逐步验证推理过程
• 📊 计算一致性检查

Gmail 集成

• 📧 通过电子邮件发送计算结果
• 📥 获取并阅读未读邮件
• 🗑️ 管理邮件（标记为已读、移至垃圾箱）
• 🌐 在浏览器中打开邮件

🏗️ 项目结构

MCP-Server-V4-Gmail/
├── calculator-mcp-server/       # Calculator MCP Server
│   ├── math-mcp-server/
│   │   ├── mcp_server.py       # Calculator implementation
│   │   └── models.py           # Data models
│   ├── pyproject.toml
│   └── README.md
└── gmail-mcp-server/           # Gmail MCP Server
    ├── src/
    │   └── gmail/
    │       ├── server.py       # Gmail integration
    │       └── __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 同意屏幕：
   • 选择“external”（无需发布）
   • 将你的邮箱添加为“Test user”
4. 添加 OAuth 范围：https://www.googleapis.com/auth/gmail/modify
5. 为“Desktop App”创建 OAuth 客户端 ID
6. 下载并保存 OAuth 凭据 JSON 文件

2. 安装服务

# Clone the repository
cd MCP-Server-V4-Gmail

# Set up Calculator Server
cd calculator-mcp-server
uv venv
uv pip install -r requirements.txt

# Set up Gmail Server
cd ../gmail-mcp-server
uv venv
uv pip install -r requirements.txt

3. 配置 Claude Desktop

将两个服务都添加到 Claude Desktop 配置文件（~/Library/Application Support/Claude/claude_desktop_config.json）中：

{
  "mcpServers": {
    "calculator": {
      "command": "uv",
      "args": [
        "--directory",
        "[path-to-repo]/calculator-mcp-server",
        "run",
        "mcp-server"
      ]
    },
    "gmail": {
      "command": "uv",
      "args": [
        "--directory",
        "[path-to-repo]/gmail-mcp-server",
        "run",
        "gmail",
        "--creds-file-path",
        "[path-to-credentials]/client_creds.json",
        "--token-path",
        "[path-to-tokens]/app_tokens.json"
      ]
    }
  }
}

💻 使用方法

1. 启动计算器服务：

   cd calculator-mcp-server
   python math-mcp-server/mcp_server.py
   

2. 启动 Gmail 服务：

   cd gmail-mcp-server
   python src/gmail/server.py --creds-file-path [path]/client_creds.json --token-path [path]/app_tokens.json
   

3. 在 Claude Desktop 中使用：

   • 执行计算：“计算 5 * (3 + 2) - 4 / 2”
   • 发送结果：“将这些计算结果发送到 [email protected]”

📋 工作流示例

1. 计算复杂表达式：

   User: Calculate (sin(45) + cos(30)) * sqrt(16)
   Claude: Let me break this down...
   [Shows step-by-step calculation]
   Result: 3.2834...
   

2. 通过电子邮件发送结果：

   User: Send this result to [email protected]
   Claude: I'll draft an email with the calculation results...
   [Shows email draft]
   Shall I send it?
   

🔒 安全性

• Gmail API 使用 OAuth 2.0 进行身份验证
• 令牌会安全地存储在指定位置
• 邮件操作需要用户明确确认

📝 许可证

MIT 许可证

👥 作者

• 计算器服务：Saish Shetty
• Gmail 集成：原作者