EAGS4 MCP Server Client

🚀 多組件平臺（MCP）服務器與雙子星AI集成

本項目打造了一個多組件平臺（MCP）服務器，並集成了雙子星AI功能。用戶可藉助自然語言指令，輕鬆執行各類數學運算和複雜任務，極大提升操作的便捷性與效率。

🚀 快速開始

本項目實現了一個多組件平臺（MCP）服務器，並集成了雙子星AI功能，你可以按照以下步驟進行操作：

1. 確保滿足先決條件：
   • Python 3.8或更高版本
   • Google雙子星API密鑰
   • macOS（用於Keynote集成）
2. 完成安裝步驟（具體見下方📦 安裝指南）。
3. 啟動服務器和客戶端（具體見下方💻 使用示例）。

✨ 主要特性

• 數學運算
  • 基本算術：涵蓋加法、減法、乘法、除法等基礎運算。
  • 高級數學：支持冪、平方根、立方根等高級運算。
  • 特殊函數：包含階乘、對數、三角函數等特殊計算。
  • 列表操作：可進行列表求和、指數求和等操作。
• 字符串處理
  • 能將字符串轉換為ASCII值。
  • 可處理字符數組。
• Keynote集成
  • 能夠打開Keynote應用程序。
  • 可繪製自定義尺寸的矩形。
  • 能在形狀中添加文本。
• AI驅動的任務執行
  • 藉助雙子星AI進行自然語言處理。
  • 可迭代解決問題。
  • 能根據用戶查詢自動選擇工具。

📦 安裝指南

1. 克隆倉庫：

   git clone https://github.com/your-repository.git
   

2. 創建並激活虛擬環境（推薦使用Python 3.8+）：

   python -m venv mcp-venv
   source mcp-venv/bin/activate  # 在Windows上使用 `mcp-venv\Scripts\activate`
   

3. 安裝依賴項：

   pip install -r requirements.txt
   

💻 使用示例

基礎用法

啟動服務器

python server.py

啟動客戶端

python client.py

高級用法

示例查詢

• 計算：What is the sum of 10 and 20?
• 轉換：Convert "Hello, World!" to ASCII.
• 繪製矩形：

{
    "action": "draw_rectangle",
    "params": {
        "width": 500,
        "height": 300
    }
}

📚 詳細文檔

項目結構

mcp-server/
├── server.py          # MCP服務器主程序
├── tools/            # 集成工具目錄
│   ├── math_tool.py  # 數學運算工具
│   └── string_tool.py# 字符串處理工具
└── requirements.txt  # 項目依賴項列表

可用工具

數學運算工具

• add：計算兩個數字的和。
• subtract：計算兩個數字的差。
• multiply：計算兩個數字的乘積。
• divide：計算兩個數字的商。

字符串處理工具

• to_ascii：將字符串轉換為ASCII表示。
• reverse：反轉給定字符串。
• uppercase：將字符串轉換為大寫。

演示視頻

錯誤處理

系統提供以下錯誤處理機制：

• AI響應超時檢測
• 類型轉換驗證
• 工具可用性檢查
• 參數有效性驗證

調試信息

調試輸出包括：

• 工具執行細節
• 參數處理流程
• 結果格式化步驟
• 錯誤消息和堆棧跟蹤

如何貢獻

1. 叉倉庫
2. 創建功能分支
3. 提交更改
4. 推送到分支
5. 創建拉取請求

📄 許可證

此項目根據MIT許可證授權，具體內容請參見LICENSE文件。

致謝

感謝以下支持：

• Google雙子星AI提供自然語言處理能力
• MCP框架提供工具管理功能
• Python社區提供的各種庫