mcp-dice: A MCP Server for Rolling Dice
2025.01.02
1
Python骰子服务随机数生成娱乐功能
mcp-dice 是一个用于掷骰子的 Model Context Protocol (MCP) 服务器，支持标准的骰子表示法（如 `1d20`），并返回单个骰子结果及其总和。它易于与 Claude Desktop 集成，并兼容 MCP Inspector 进行调试。
View on GitHub
Overview
基本能力
产品定位
mcp-dice 是一个专门用于掷骰子的 MCP 服务器，旨在为大型语言模型（LLMs）提供骰子滚动功能。
核心功能
- 支持标准的骰子表示法（如
1d20,3d6,2d8+1） - 返回单个骰子结果和总和
- 易于与 Claude Desktop 集成
- 兼容 MCP Inspector 进行调试
适用场景
- 游戏开发中的随机数生成
- 桌面角色扮演游戏（RPG）的骰子功能
- 任何需要随机数生成的场景
工具列表
- MCP Inspector: 用于调试 MCP 服务器的工具，可以通过 npm 安装和使用。
- Smithery: 用于自动安装 mcp-dice 到 Claude Desktop 的工具。
常见问题解答
- 如何安装 mcp-dice？ 可以通过 Smithery 自动安装，或手动克隆仓库并安装依赖。
- 如何调试 mcp-dice？ 使用 MCP Inspector 进行调试。
使用教程
使用依赖
确保 uv 可用，安装指南参考：uv 安装指南
安装教程
通过 Smithery 安装
npx @smithery/cli install mcp-dice --client claude
手动安装
git clone https://github.com/yourusername/mcp-dice
cd mcp-dice
uv pip install -e "."
调试方式
运行测试
uv run pytest
使用 MCP Inspector 调试
npx @modelcontextprotocol/inspector uvx mcp-dice