mcp-(mcp-server-diceroll)

🚀 MCP 服务器掷骰子 (mcp-server-diceroll)

这是一个基于 MCP（模型调用协议）的简单服务器演示项目，提供基本的数值运算功能和可定制的掷骰子功能，为用户带来多样化的实用体验。

🚀 快速开始

本项目是基于 MCP 的服务器演示，启动后可使用多种工具进行数值运算、掷骰子等操作。

✨ 主要特性

• 数值加法：能对两个数值进行加法运算。
• 可自定义面数和次数的掷骰子：用户可按需设置骰子的面数和投掷次数。
• UUID 生成（支持版本 4 或版本 1）：支持生成不同版本的 UUID。
• 动态问候语生成：能根据指定名称生成问候语。

📦 安装指南

环境要求

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

安装步骤

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 server.py

或使用 uv 执行：

uv run python server.py

工具使用

启动后，您可以使用以下工具：

1. add - 加法两个数值
2. roll_dice - 掷骰子（默认为六面体一次）
3. generate_uuid - 生成 UUID（默认版本 4，支持版本 1 指定）
4. greeting://{name} - 生成带有指定名称的问候语

📚 详细文档

参考资料

• 从掷骰子开始了解模型上下文协议 (MCP)
• Anthropic MCP 官方发布
• modelcontextprotocol/python-sdk

示例说明

有关如何向服务器发送请求，请参考 MCP 客户端文档。