计算器与Gmail集成套件

一个结合高级计算功能和Gmail集成的MCP服务器套件,支持复杂数学运算并通过Claude桌面客户端发送邮件结果。

  • by shettysaish20
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 shettysaish20/mcp-server-v4-gmail

使用说明

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或更高版本
  • 克劳德桌面MCP客户端
  • 谷歌云平台账户(适用于Gmail API)

1.Gmail API设置

  1. 创建一个 新的谷歌云项目
  2. 启用 Gmail API
  3. 配置 OAuth同意屏幕:
    • 选择“外部”(无需发布)
    • 将您的电子邮件添加为“测试用户”
  4. 添加OAuth作用域: https://www.googleapis.com/auth/gmail/modify
  5. 创建 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配置中(~/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”
    • 发送结果:“将这些计算结果发送至example@email.com"

📋 工作流示例

  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 john@example.com
    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集成