MCP 智能代理

此项目展示了一个智能代理，该代理能够执行复杂的数学运算、创建视觉演示文稿，并通过 Google 服务发送电子邮件结果。它展示了多个 MCP（模型上下文协议）服务器协同工作的能力，以解决复合任务。

项目目标

主要目标是完成以下任务：

计算前五个斐波那契数的指数和，将答案写入幻灯片中，将其下载为 PNG 文件并通过电子邮件发送。

这涉及：

1. 数学计算（斐波那契 + 指数）
2. 视觉演示（Google 幻灯片）
3. 通信（Gmail）

系统架构

系统由三个主要的 MCP 服务器组成：

1. 数学服务器 (mcp_servers/math_server.py)

   • 计算斐波那契序列
   • 执行指数运算
   • 处理数学计算

2. 幻灯片服务器 (mcp_servers/slides_server.py)

   • 创建 Google 幻灯片演示文稿
   • 向幻灯片中添加文本
   • 将幻灯片下载为 PNG 图像文件

3. Gmail 服务器 (mcp_servers/gmail_server.py)

   • 发送带附件的电子邮件
   • 管理电子邮件操作（读取、移动到垃圾邮件、标记为已读）
   • 处理 Gmail API 身份验证

设置说明

先决条件

• Python 3.8+
• Linux/Unix 环境（已在 Linux 5.15.0-136-generic 上测试通过）
• X11 显示服务器（用于幻灯片功能）
• 带有 Gmail 和 Google 幻灯片访问权限的 Google 账户

安装

1. 克隆仓库
2. 安装依赖项：

pip install -r requirements.txt

Google API 设置

1. Gmail 设置：

   • 在 Google Cloud Console 中创建项目
   • 启用 Gmail API
   • 创建 OAuth 2.0 凭证
   • 将凭证保存为 mcp_servers/credentials.json

2. 环境变量（可选）：

   • GMAIL_CREDS_FILE：凭据文件的路径
   • GMAIL_TOKEN_FILE：令牌文件的路径

使用方法

1. 启动代理：

python agent.py

2. 系统将执行以下操作：
   • 计算斐波那契序列和指数值
   • 创建包含结果的幻灯片
   • 将幻灯片保存为 PNG 文件到 content/slide.png
   • 通过电子邮件发送 PNG 文件

项目结构

.
├── agent.py              # 主代理实现文件
├── ai.py                 # Gemini 交互
├── prompt.py             # 项目使用的提示语
├── mcp_servers/
│   ├── slides_server.py  # Google 幻灯片操作
│   ├── gmail_server.py   # Gmail 操作
│   └── math_server.py    # 数学计算
├── content/              # 生成的内容（幻灯片、图像）
└── requirements.txt      # 项目依赖项

故障排除

• 显示问题：确保 X11 显示服务器正在运行
• Gmail 授权：
  • 第一次运行时会提示 Google 账户访问权限
  • 如果授权失败，删除 token.json 文件后重试
• 文件路径：
  • 图像保存在 content/slide.png
  • 使用绝对路径指定文件位置

示例输出

运行代理后，您应该会看到：

1. 控制台中显示数学计算结果
2. 在内容目录下找到 PNG 文件
3. 收到包含 PNG 附件的电子邮件

执行日志