MCP (mcp Server Diceroll)

🚀 MCP 服務器擲骰子 (mcp-server-diceroll)

本項目是一個基於 MCP（模型調用協議）的簡單服務器演示項目，提供基本的數值運算功能以及可定製的擲骰子功能，能滿足多樣化的使用需求。

🚀 快速開始

啟動服務器，您可以選擇以下兩種方式：

python server.py

或使用 uv 執行：

uv run python server.py

啟動後，您可以使用以下工具：

1. add - 加法兩個數值
2. roll_dice - 擲骰子（默認為六面體一次）
3. generate_uuid - 生成 UUID（默認版本4，支持版本1指定）
4. greeting://{name} - 生成帶有指定名稱的問候語

✨ 主要特性

• 數值加法：實現基本的數值加法運算。
• 可自定義面數和次數的擲骰子：能根據需求自定義骰子的面數和投擲次數。
• UUID 生成：支持版本 4 或版本 1 的 UUID 生成。
• 動態問候語生成：可生成帶有指定名稱的問候語。

📦 安裝指南

1. 克隆代碼倉庫：

git clone https://github.com/yourusername/mcp-server-diceroll.git
cd mcp-server-diceroll

2. 如果尚未安裝 uv，請運行以下命令進行安裝：

curl -sSf https://astral.sh/uv/install.sh | bash

3. 使用 uv 創建虛擬環境並安裝依賴項：

uv venv
source .venv/bin/activate  # 適用於 macOS/Linux
# 或者
.venv\Scripts\activate  # 適用於 Windows

uv pip install -e .

📚 詳細文檔

系統要求

• Python 3.12 或更高版本
• mcp 庫 1.6.0 或更高版本
• uv (Python 包管理工具)

參考資料

• 從擲骰子開始瞭解模型上下文協議 (MCP)
• Anthropic MCP 官方發佈
• modelcontextprotocol/python-sdk

示例

有關如何向服務器發送請求，請參考 MCP 客戶端文檔。