Utilities Box MCP Server

🚀 基於gRPC協議的MCP（微服務控制協議）工具集

本工具集基於gRPC協議實現，提供了一系列實用工具，可用於微服務開發和全雙工通信，能有效提升開發效率和通信質量。

🚀 快速開始

本工具集提供了一組實用工具，用於實現微服務和全雙工通信。以下是可用的MCP工具：

1. 計算器工具
2. 睡眠工具
3. 生成UUID工具

✨ 主要特性

計算器工具

• 允許用戶在表達式中使用變量進行數值計算。
• 支持加法、減法、乘法和除法等基本操作。

睡眠工具

使服務器在指定的時間段內暫停執行。

生成UUID工具

用於生成指定數量和版本的UUID（通用唯一標識符），默認生成版本4的隨機UUID。

💻 使用示例

計算器工具

基礎用法

# 本地運行計算器服務
python calculator_server.py

# 客戶端調用計算器服務進行計算
result = calculator_service.evaluate(expression="2 + 3", variables={})
print(f"結果: {result}")

睡眠工具

基礎用法

# 本地運行睡眠服務
python sleep_server.py

# 客戶端調用睡眠服務
response = sleep_service.sleep(time_value=5, time_unit="seconds")
print(response.message)

生成UUID工具

基礎用法

# 本地運行生成UUID服務
python uuid_server.py

# 客戶端調用生成UUID服務
uuids = uuid_service.generate_uuid(count=5, version="v4")
print(uuids)

🔧 技術細節

所有工具在出現錯誤時都會拋出相應的異常。具體如下：

• 計算器工具：如果表達式無效或變量不正確，將拋出ValueError。
• 睡眠工具：如果時間值非正或單位無效，將拋出ValueError。
• 生成UUID工具：如果版本無效或缺少命名空間/名稱參數（對於v3和v5），將拋出ValueError。

請參考每個工具的文檔以獲取更多詳細信息。