Eagv1 S4 MCP

🚀 數學運算代理（集成 Microsoft Word 和 Gmail）

這是一款基於 Python 的數學運算代理，它藉助多種數學工具迭代解決問題，並能通過 Microsoft Word 和 Gmail 對結果進行可視化展示，為數學問題的處理提供了高效且直觀的解決方案。

🚀 快速開始

本數學運算代理可快速解決各類數學問題，以下是使用前的準備和啟動步驟：

先決條件

• Python 3.7+
• macOS 上的 Microsoft Word
• macOS 10.15 或更高版本
• Google Cloud API 密鑰（用於 Gemini Pro）

安裝

1. 克隆倉庫。
2. 安裝依賴項：

pip3 install -r requirements.txt

3. 設置環境變量：
   • 選項 1：終端中導出（推薦用於測試）：

export GEMINI_API_KEY=your_api_key_here
export GMAIL_USER=your.email@gmail.com
export GMAIL_APP_PASSWORD=your16digitpassword

- 選項 2：創建 .env 文件：

GEMINI_API_KEY=your_api_key_here
GMAIL_USER=your.email@gmail.com
GMAIL_APP_PASSWORD=your16digitpassword

啟動

• 推薦方法：運行客戶端（自動啟動服務器）：

python math_agent_client.py

• 調試方法（可選）：分別運行服務器和客戶端：
  1. 啟動 MCP 服務器：

# 終端 1
python math_agent_server.py

# 終端 2
python math_agent_client.py

啟動代理後，它將完成以下操作：

• 內部啟動 MCP 服務器。
• 使用 Gemini AI 處理數學查詢。
• 執行可用工具的計算。
• 創建包含結果的 Word 文檔。
• 繪製一個矩形以顯示最終答案。
• 發送帶有執行日誌的電子郵件報告。

✨ 主要特性

數學運算

• 基本算術運算：支持加、減、乘、除等基本操作。
• 高級運算：涵蓋冪、平方根、立方根等高級計算。
• 三角函數：可進行正弦、餘弦、正切等三角函數計算。
• 對數計算：實現對數相關運算。
• 階乘計算：能快速計算階乘。
• 斐波那契數列生成：生成指定的斐波那契數列。
• ASCII 值轉換：進行字符與 ASCII 值的轉換。
• 指數和計算：完成指數和的計算。

人工智能集成

• 智能問題解決：使用 Google Gemini Pro 模型實現智能問題解決。
• 迭代式方法：採用迭代式問題解決方法。
• 自動工具選擇：自動選擇並執行合適的工具。

增強日誌記錄

• 詳細執行日誌：記錄詳細的執行過程。
• 調試信息：包含工具操作的調試信息。
• 錯誤跟蹤：進行錯誤跟蹤和報告。
• 綜合報告：生成包含執行歷史的綜合電子郵件報告。

電子郵箱集成

• 自動報告：自動發送完成後的電子郵件報告。
• 詳細日誌：郵件正文包含詳細執行日誌。
• 結果摘要：提供最終結果摘要。
• SMTP 集成：實現 Gmail SMTP 集成。

Word 集成

• 文檔生成：自動生成 Word 文檔。
• 結果繪製：繪製結果矩形。
• 可視化展示：自動化結果可視化。
• 位置配置：支持文本位置配置。

💻 使用示例

基礎用法

以下是一些示例查詢，你可以將這些查詢輸入到代理中進行測試：

- 查找 INDIA 中字符的 ASCII 值，然後返回這些值指數和的結果總和
- 計算 5 的階乘
- 求前 10 個斐波那契數之和

🔧 技術細節

架構

• math_agent_client.py：作為主客戶端，負責處理以下任務：
  • 集成 Gemini AI。
  • 處理查詢。
  • 執行工具。
  • 對 Word 結果進行可視化。
• math_agent_server.py：服務器提供以下功能：
  • 數學工具。
  • Word 集成工具。
  • 資源處理器。

錯誤處理

• 超時保護：為 AI 生成功效提供超時保護。
• 魯棒處理：對工具執行進行魯棒的錯誤處理。
• 狀態重置：自動進行狀態重置。
• 調試日誌：記錄調試日誌。

日誌記錄

• 時間戳記錄：所有操作均按時間戳記錄。
• 多日誌級別：日誌級別包括 INFO、DEBUG、ERROR。
• 報告包含：日誌包含在電子郵件報告中。
• 即時監控：控制檯輸出用於即時監控。

🛠️ 故障排除

電子郵箱配置

• 確保 GMAIL_USER 是您的完整電子郵件地址。
• GMAIL_APP_PASSWORD 必須是 16 字符的'app'密碼。
• 啟用 Google 賬戶的雙重驗證。
• 查看執行日誌獲取詳細錯誤信息。

Word 集成

• 確保 Microsoft Word 已安裝並在您的系統上正確配置。
• 檢查運行代理的用戶是否有權限訪問 Word 安裝目錄。

⚠️ 注意事項

• 本代理需要互聯網連接才能使用 Gemini AI 服務。
• 建議在首次使用前檢查所有依賴項是否正確安裝。
• 如遇問題，請查看日誌文件或聯繫支持團隊。