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 設置時，請嚴格按照步驟操作，確保憑證文件和環境變量配置正確，以避免授權和訪問問題。