Agent MCP Math Draw

🚀 基於MCP的數學繪圖客戶端

本項目中的 talk2mcp_math_draw_client.py 是一款強大的Python應用程序，它巧妙地將數學計算與可視化繪圖功能相結合。藉助Gemini AI模型，該程序能夠高效處理各類數學問題，並生成直觀的響應結果，為用戶帶來便捷的數學問題解決體驗。

✨ 主要特性

已實現的功能

• 智能求解：與Gemini AI深度集成，可精準求解各類數學問題。
• 可視化展示：具備繪圖功能，能以直觀的視覺形式呈現數學計算結果。
• 迭代求解：採用迭代解決問題的方法，最多支持9次迭代，確保複雜問題也能得到有效解決。
• 多元運算支持：支持基本數學運算以及ASCII值計算，滿足多樣化的計算需求。
• 自動繪圖：可自動在畫布上繪製計算結果，無需手動干預。
• 穩定可靠：擁有基本錯誤處理與恢復機制，保障程序運行的穩定性。
• 便捷操作：提供簡單的畫布操作和基本文本放置功能，方便用戶使用。
• 超時控制：對操作進行超時控制，LLM操作默認10秒超時，避免長時間等待。
• 會話管理：支持會話管理，方便用戶進行多輪交互。
• 工具驗證：實現工具執行及參數驗證，確保操作的準確性。

📦 安裝指南

服務器要求

1. 運行環境：
   • 需配置Python 3.x運行環境。
   • 安裝MCP服務器包。
   • 安裝必要的服務器依賴項：
     • mcp 包
     • google-generativeai 用於AI集成
     • python-dotenv 用於環境管理
2. 服務器配置：
   • 端口設置（默認：8080）
   • 合理分配數學運算內存
   • 畫布大小設置（默認：1920x1080）
   • 設置最大併發連接數
   • 超時控制（默認：10秒）
3. 先決條件：
   • 安裝必要的Python包。
   • 配置Gemini API密鑰。
   • 確保網絡連通性。

環境設置

1. 創建config.json文件，內容如下：

   {
       "canvas_size": "1920x1080",
       "max_connections": 5,
       "timeout": 10
   }
   

   將該文件置於項目根目錄。

📚 詳細文檔

功能實現

• 通信機制：連接到MCP服務器，使用標準輸入輸出進行通信。
• 智能處理：藉助Gemini AI模型處理數學查詢，提供準確的解答。
• 結果展示：自動在畫布上顯示計算結果，直觀呈現。
• 迭代求解：對於複雜問題，最多進行9次迭代求解，確保問題解決。
• 操作驗證：通過工具模式驗證操作，保證操作的有效性。
• 錯誤處理：內置錯誤處理機制，應對各種異常情況。

錯誤處理

系統具備完善的錯誤處理機制，可處理以下常見錯誤：

• API超時：默認10秒超時，避免長時間等待。
• 無效輸入：對用戶輸入進行驗證，避免無效操作。
• 連接問題：處理與服務器的連接異常，確保通信穩定。
• 工具執行錯誤：對工具執行過程中的錯誤進行捕獲和處理。
• 繪圖工具失敗：處理繪圖工具可能出現的故障。
• 參數驗證錯誤：驗證操作參數的有效性，避免錯誤操作。
• 會話管理問題：處理會話管理過程中可能出現的異常。

性能提示

1. 優化建議：
   • 選擇合適的畫布大小，避免資源浪費。
   • 限制併發操作數量，保證系統性能。
   • 及時清理無用資源，釋放系統內存。
   • 監控內存使用情況，確保系統穩定運行。
   • 採用高效算法，提高計算效率。
2. 最佳實踐：
   • 定期備份系統，防止數據丟失。
   • 及時更新軟件版本，獲取最新功能和修復。
   • 監控系統資源，及時發現並解決性能問題。
   • 記錄錯誤日誌，方便問題排查和修復。
   • 進行性能測試，評估系統性能並進行優化。

問題排查

1. 常見問題：
   • 連接超時
   • 繪圖工具失敗
   • 內存不足
   • 性能低下
   • 鑑權錯誤
2. 解決方案：
   • 檢查服務器狀態，確保服務器正常運行。
   • 確保網絡連通性，避免網絡故障影響使用。
   • 清理緩存文件，釋放系統空間。
   • 更新依賴項，獲取最新的功能和修復。
   • 監控系統資源使用情況，及時發現並解決性能問題。