Utilities Box MCP Server

🚀 基于gRPCのMCP（マイクロサービス制御プロトコル）ツールセット

このドキュメントでは、gRPCプロトコルに基づくMCP（マイクロサービス制御プロトコル）ツールセットについて説明します。このツールセットは、マイクロサービスと全二重通信を実現するための一連の便利なツールを提供します。

🚀 クイックスタート

この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がスローされます。

各ツールのドキュメントを参照して、詳細情報を取得してください。