MCP AI Agent

🚀 MCP 智能代理

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

🚀 快速开始

本项目的主要目标是完成以下复合任务：计算前五个斐波那契数的指数和，将答案写入幻灯片中，把幻灯片下载为 PNG 文件并通过电子邮件发送。这一过程涵盖了数学计算（斐波那契 + 指数）、视觉演示（Google 幻灯片）以及通信（Gmail）等多个方面。

启动代理

python agent.py

系统将自动执行以下操作：

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

示例输出

运行代理后，您会看到如下结果：

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

执行日志

✨ 主要特性

• 能够执行复杂的数学运算，包括斐波那契序列计算和指数运算。
• 可创建 Google 幻灯片演示文稿，并将计算结果写入其中。
• 支持将幻灯片下载为 PNG 文件，并通过 Gmail 发送带附件的电子邮件。
• 展示了多个 MCP 服务器协同工作解决复合任务的能力。

📦 安装指南

先决条件

• 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：令牌文件的路径

📚 详细文档

系统架构

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

1. 数学服务器 (mcp_servers/math_server.py)
   • 计算斐波那契序列
   • 执行指数运算
   • 处理数学计算
2. 幻灯片服务器 (mcp_servers/slides_server.py)
   • 创建 Google 幻灯片演示文稿
   • 向幻灯片中添加文本
   • 将幻灯片下载为 PNG 图像文件
3. Gmail 服务器 (mcp_servers/gmail_server.py)
   • 发送带附件的电子邮件
   • 管理电子邮件操作（读取、移动到垃圾邮件、标记为已读）
   • 处理 Gmail API 身份验证

项目结构

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

🔧 技术细节

本项目涉及多个 MCP 服务器的协同工作，每个服务器负责不同的任务。数学服务器专注于数学计算，幻灯片服务器负责创建和处理 Google 幻灯片，Gmail 服务器则管理电子邮件的发送和相关操作。通过 MCP 协议，这些服务器能够高效地协同工作，完成复合任务。同时，项目依赖于 Python 环境和 Google API，需要进行相应的配置和授权。

🔧 故障排除

⚠️ 重要提示

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

💡 使用建议

在进行 Google API 设置时，请严格按照步骤操作，确保凭证文件和环境变量配置正确，以避免授权和访问问题。