🚀 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 集成由原始作者开发。