MCP AI Agent

该项目展示了一个智能代理，能够执行复杂数学运算、创建可视化演示并通过谷歌服务发送邮件结果，集成了多个MCP服务器协作完成复合任务。

人工智能聊天机器人教育与学习工具 #数学计算 #幻灯片 #邮件发送 .Python

rating : 2 points

downloads : 22

update time : 2025-04-29

什么是MCP AI Agent?

MCP AI Agent是一个智能系统，能够自动完成复杂任务链，包括数学计算、可视化呈现和邮件通信。它通过三个专业服务器协同工作，模拟人类处理复合任务的完整流程。

如何使用MCP AI Agent?

只需启动主程序，系统会自动完成：1)计算斐波那契数列的指数和 2)生成结果幻灯片 3)发送邮件。整个过程无需人工干预。

适用场景

适合需要自动生成报告并分发的场景，如每日数据简报、学术计算结果共享、自动化工作报告等。

主要功能

数学计算专业数学服务器，可计算斐波那契数列和指数运算

幻灯片生成自动创建美观的Google Slides演示文稿并导出为PNG图片

邮件发送通过Gmail API安全发送带附件的电子邮件

优势与局限性

优势

一站式解决复合任务，无需切换不同工具

自动化流程节省人工操作时间

基于Google服务，可靠性高

局限性

需要Google账号授权

首次使用需配置API凭证

目前仅支持特定预设任务流程

如何使用

环境准备

确保已安装Python 3.8+和X11显示服务(Linux)

安装依赖

通过pip安装所需软件包

Google API配置

在Google Cloud Console创建项目并启用Gmail API，下载凭证文件

运行系统

启动主程序开始自动化流程

使用案例

学术报告自动化研究人员可自动计算实验数据并发送给团队成员

每日数据简报自动生成业务数据报告并发送给管理层

常见问题

为什么需要X11显示服务?

如何获取Google API凭证?

能否修改计算任务?

🚀 MCP 智能代理

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

🚀 快速开始

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

启动代理

python agent.py

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

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

示例输出

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

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

执行日志

✨ 主要特性

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

📦 安装指南

先决条件

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

安装步骤

克隆仓库
安装依赖项：

pip install -r requirements.txt

Google API 设置

Gmail 设置：
- 在 Google Cloud Console 中创建项目
- 启用 Gmail API
- 创建 OAuth 2.0 凭证
- 将凭证保存为 mcp_servers/credentials.json
环境变量（可选）：
- GMAIL_CREDS_FILE：凭据文件的路径
- GMAIL_TOKEN_FILE：令牌文件的路径

📚 详细文档

系统架构

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

数学服务器 (mcp_servers/math_server.py)
- 计算斐波那契序列
- 执行指数运算
- 处理数学计算
幻灯片服务器 (mcp_servers/slides_server.py)
- 创建 Google 幻灯片演示文稿
- 向幻灯片中添加文本
- 将幻灯片下载为 PNG 图像文件
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，需要进行相应的配置和授权。