dice-roller

MCP 掷骰器 🎲

一个用于掷骰子的简单 MCP（Model Context Protocol）服务。非常适合桌面游戏、随机决策等场景！

功能

• 标准骰子记法 - 使用 2d6、1d20+5、3d8-2 等记法掷骰子
• 保留最高/最低点数 - 支持 4d6kh3（保留最高的 3 个）和 2d20kl1（保留最低的 1 个）
• D&D 属性掷骰 - 使用 4d6 丢弃最低点数，快速生成角色属性
• 抛硬币 - 简单的正面或反面
• 随机选择器 - 从选项列表中随机选择
• 百分骰 - 使用十位骰和个位骰掷 d100

安装

pip install mcp-dice-roller

使用方法

搭配 Claude Desktop 使用

添加到 Claude Desktop 配置文件（macOS 上为 ~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "dice-roller": {
      "command": "python",
      "args": ["-m", "mcp_dice_roller"]
    }
  }
}

搭配 VS Code 使用

添加到 VS Code MCP 设置：

{
  "mcp.servers": {
    "dice-roller": {
      "command": "python",
      "args": ["-m", "mcp_dice_roller"]
    }
  }
}

工具

roll_dice

使用标准记法掷骰子。

roll_dice("2d6")       → Roll two 6-sided dice
roll_dice("1d20+5")    → Roll d20 and add 5
roll_dice("4d6kh3")    → Roll 4d6, keep highest 3
roll_dice("2d20kl1")   → Roll 2d20, keep lowest (disadvantage)

响应示例：

{
  "notation": "2d6+3",
  "rolls": [4, 6],
  "kept": [4, 6],
  "subtotal": 10,
  "modifier": 3,
  "total": 13
}

roll_multiple

多次掷相同的骰子并统计结果。

roll_multiple("1d20", 5)  → Roll d20 five times

响应示例：

{
  "notation": "1d20",
  "times": 5,
  "totals": [15, 8, 20, 3, 12],
  "statistics": {
    "min": 3,
    "max": 20,
    "sum": 58,
    "average": 11.6
  }
}

roll_dnd_stats

生成 D&D 5e 角色属性值。

响应示例：

{
  "method": "4d6 drop lowest",
  "stats": [
    {"rolls": [4, 3, 5, 6], "kept": [4, 5, 6], "total": 15},
    {"rolls": [2, 4, 4, 3], "kept": [3, 4, 4], "total": 11},
    ...
  ],
  "totals": [15, 11, 14, 13, 10, 16],
  "sum": 79
}

flip_coin

抛硬币。

flip_coin()      → Flip once
flip_coin(10)    → Flip 10 times

pick_random

从选项中随机选择。

pick_random("pizza, burger, sushi, tacos")

响应示例：

{
  "options": ["pizza", "burger", "sushi", "tacos"],
  "selected": "sushi",
  "total_options": 4
}

roll_percentile

掷 d100（百分骰）。

响应示例：

{
  "tens_die": 7,
  "ones_die": 3,
  "result": 73
}

开发

设置

# Clone the repository
git clone https://github.com/vandewilly/mcp-dice-roller.git
cd mcp-dice-roller

# Install dependencies
pip install -e ".[dev]"

# Run tests
pytest

本地运行

python -m mcp_dice_roller

MCP Registry

MCP 名称： io.github.vandewilly/dice-roller

此服务已发布到 MCP Registry。

许可证

MIT License - 详见 LICENSE。

作者

Vandewilly Silva (@vandewilly)