MCP Math Gmail Client

MCP Math Gmail Client

Math Gmail Client（talk2mcp_math_gmail_client.py）是一个将数学计算与 Gmail 功能相结合的 Python 应用程序。它使用 Gemini AI 模型处理数学查询，并可通过电子邮件发送结果。

功能

• 集成 Gemini AI 以解决数学问题
• 集成 Gmail 以发送数学结果
• 迭代式解题方法
• 支持各种数学运算
• 自动生成包含数学结果的电子邮件
• 安全的 Gmail 身份验证
• 支持多个收件人

服务端要求

1. MCP 服务设置：
   • Python 3.x 环境
   • 已安装 MCP 服务包
   • 所需的服务端依赖项：
     • mcp package

先决条件

• Python 3.x
• 所需的 Python 包：
  • python-dotenv
  • google-generativeai
  • mcp package
  • google-auth
  • google-auth-oauthlib
  • google-auth-httplib2
  • google-api-python-client

环境设置

1. 在项目根目录中创建 .env 文件
2. 添加 API 密钥：

   GEMINI_API_KEY=your_api_key_here
   GMAIL_CLIENT_ID=your_client_id_here
   GMAIL_CLIENT_SECRET=your_client_secret_here
   

服务端设置

1. 安装服务端依赖项：

   pip install mcp numpy pandas matplotlib
   

2. 启动 MCP 服务：

   python example2-3_gmail_server_2.py
   

可用工具

当前已实现的工具

1. 数学运算：

   • 基本算术运算（加、减、乘、除）
   • 高级数学函数（指数、对数）
   • ASCII 值计算
   • 字符串处理与转换
   • 数组运算
   • 素数计算
   • 阶乘计算
   • 斐波那契数列生成

2. 电子邮件工具：

   • 向单个收件人发送电子邮件
   • 基本电子邮件格式设置
   • 简单的附件处理
   • 基本错误处理
   • Gmail 身份验证
   • 电子邮件队列管理
   • 基本投递状态跟踪

安装

1. 克隆仓库
2. 安装所需的包：

   pip install python-dotenv google-generativeai mcp google-auth google-auth-oauthlib google-auth-httplib2 google-api-python-client
   

3. 按照上述说明设置环境变量
4. 设置 Gmail API 凭据：
   • 前往 Google Cloud Console
   • 创建新项目
   • 启用 Gmail API
   • 创建 OAuth 2.0 凭据
   • 下载凭据文件

使用方法

1. 启动 MCP 服务（参见“服务端设置”部分）
2. 确保服务正在运行且可以访问
3. 运行客户端：

   python talk2mcp_math_gmail_client.py
   

服务端与客户端通信

1. 连接协议：

   • 客户端与服务端建立连接
   • 身份验证握手
   • 工具列表同步
   • 会话初始化
   • 电子邮件服务验证

2. 数据流：

   • 客户端发送数学查询
   • 服务端处理请求
   • 将结果整理为电子邮件格式
   • 管理电子邮件队列
   • 跟踪投递状态
   • 发送通知

3. 错误处理：

   • 连接重试机制
   • 会话恢复
   • 电子邮件队列恢复
   • 速率限制处理
   • 资源清理

示例查询

1. 基本数学邮件：

Calculate the factorial of 10 and send the result to [email protected] with the subject "Factorial Calculation Result".

2. 复杂数学分析：

Find the first 50 Fibonacci numbers, calculate their sum, and send the detailed analysis to [email protected] with a graph attachment.

3. 带格式的多项运算：

Calculate the roots of the quadratic equation x² + 5x + 6 = 0, format the solution in LaTeX, and send it to [email protected] with proper mathematical notation.

4. 定时数学报告：

Generate a report of prime numbers between 1 and 1000, create a histogram of their distribution, and schedule it to be sent to [email protected] tomorrow at 9:00 AM.

工作原理

1. 客户端连接到 MCP 服务
2. 使用 Gemini AI 模型处理数学查询
3. 将结果整理为电子邮件格式
4. 系统使用迭代方法解决复杂问题
5. 通过 Gmail 将结果发送给指定收件人

错误处理

客户端包含针对以下情况的健壮错误处理：

• API 超时
• 无效输入
• 连接问题
• 工具执行错误
• Gmail 身份验证和发送错误

安全性

• 使用 OAuth 2.0 进行 Gmail 身份验证
• 安全存储 API 密钥和凭据
• 与 Gmail API 通信时使用加密

贡献

欢迎提交问题和改进请求。

许可证

根据 Apache License 2.0 版（“许可证”）授权； 除非遵守许可证，否则不得使用此文件。 您可以通过以下地址获取许可证副本：

http://www.apache.org/licenses/LICENSE-2.0

除非适用法律要求或书面同意，否则按“原样”分发本软件， 不提供任何明示或默示的担保或条件。 有关许可证下特定语言所规定的权限和 限制，请参阅许可证。

故障排除

1. 常见问题：

   • 邮件发送失败
   • 附件大小限制
   • 身份验证问题
   • 速率限制问题
   • 连接超时

2. 解决方案：

   • 检查邮件服务状态
   • 验证 API 配额
   • 查看错误日志
   • 检查网络连接
   • 验证凭据

性能提示

1. 优化：

   • 对大型邮件进行批处理
   • 压缩附件
   • 连接池
   • 缓存管理
   • 资源监控

2. 最佳实践：

   • 定期备份邮件模板
   • 监控 API 使用情况
   • 实施重试机制
   • 使用高效的数据结构
   • 定期维护系统