MCP Server Suite: Calculator + Gmail Integration

Overview

🌟 核心功能

高级计算器

支持复杂的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设置

创建一个新的Google Cloud项目
启用Gmail API
配置OAuth同意屏幕:
选择"external"（无需发布）
将您的电子邮件添加为"测试用户"
添加OAuth范围：https://www.googleapis.com/auth/gmail/modify
为"桌面应用"创建OAuth客户端ID
下载并保存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配置（~/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"
      ]
    }
  }
}

💻 使用教程

启动计算器服务器： bash cd calculator-mcp-server python math-mcp-server/mcp_server.py
启动Gmail服务器： bash cd gmail-mcp-server python src/gmail/server.py --creds-file-path [path]/client_creds.json --token-path [path]/app_tokens.json
在Claude Desktop中使用：
执行计算："Calculate 5 * (3 + 2) - 4 / 2"
发送结果："Send these calculation results to [email protected]"

📋 示例工作流程

计算复杂表达式： User: Calculate (sin(45) + cos(30)) * sqrt(16) Claude: Let me break this down... [Shows step-by-step calculation] Result: 3.2834...
通过电子邮件发送结果： 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集成由原始作者开发

许可证

该项目遵循 Other 开源许可条款，请参阅 Other 了解完整条款。