🚀 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 客户端文档。