项目介绍

这个文档介绍了基于gRPC协议的MCP（微服务控制协议）工具集。该工具集提供了一组实用工具，用于实现微服务和全双工通信。

工具列表

以下是可用的MCP工具：

1. 计算器工具
2. 睡眠工具
3. 生成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（通用唯一标识符）。默认情况下，生成一个版本4的随机UUID。

使用示例

# 本地运行生成UUID服务
python uuid_server.py

# 客户端调用生成UUID服务
uuids = uuid_service.generate_uuid(count=5, version="v4")
print(uuids)

异常处理

所有工具在出现错误时都会抛出相应的异常。例如：

• 计算器工具：如果表达式无效或变量不正确，将抛出ValueError。
• 睡眠工具：如果时间值非正或单位无效，将抛出ValueError。
• 生成UUID工具：如果版本无效或缺少命名空间/名称参数（对于v3和v5），将抛出ValueError。

请参考每个工具的文档以获取更多详细信息。