Dice Roll

server-dice-roll

用于模拟掷骰子的模型上下文协议（MCP）服务，支持标准骰子记法和 Fate/Fudge 骰子。

功能

• 骰子记法解析：解析 2d6、1d20+5 或 4dF 等标准骰子记法字符串
• 多种骰子类型：支持标准骰子和 Fate/Fudge 骰子
• 随机掷骰：生成真正随机的掷骰结果，并具有准确的概率分布
• 验证：使用 Zod 架构完整验证输入和输出
• MCP 集成：可与 Claude Desktop 等任何兼容 MCP 的客户端无缝集成

用法

此 MCP 服务提供两个主要工具：

1. 解析骰子记法

解析骰子记法字符串，并返回结构化表示。

parse_dice_roll_notation
  input: { notation: "3d6+4" }
  output: { type: "standard", count: 3, sides: 6, modifier: 4 }

2. 掷骰子

根据掷骰配置掷骰，并返回结果。

dice_roll
  input: { type: "standard", count: 3, sides: 6, modifier: 4 }
  output: { rolls: [5, 2, 6], total: 17, original: "3d6+4" }

安装和设置

与 Claude Desktop 配合使用

将此服务添加到 Claude Desktop 配置中：

{
  "mcpServers": {
    "dice": {
      "command": "npx",
      "args": ["-y", "server-dice-roll"]
    }
  }
}

使用 npm/npx

# Install globally
npm install -g server-dice-roll

# Run the server
mcp-server-dice-roll

# Or run directly with npx
npx server-dice-roll

了解骰子记法

骰子记法是一种桌面角色扮演游戏中用于表示不同掷骰方式的系统。

标准记法

标准格式为 NdS+M，其中：

• N 是要掷的骰子数量（可选，默认为 1）
• d 表示掷骰
• S 是每个骰子的面数
• +M 是要加到总数上的修正值（可选）

示例：

• d6 - 掷一个 6 面骰
• 2d10 - 掷两个 10 面骰，并将结果相加
• 3d8+5 - 掷三个 8 面骰，将结果相加，再加 5

Fate/Fudge 骰子

Fate 骰子（也称为 Fudge 骰子）是特殊的 6 面骰，取值为 -1、0 和 +1（每种值各占两面）。

格式：NdF，其中：

• N 是要掷的骰子数量
• dF 表示 Fate 骰子

示例：

• 4dF - 掷四个 Fate 骰子（结果介于 -4 和 +4 之间）

许可证

此项目采用 MIT 许可证授权，详情请参阅 LICENSE.md 文件。

作者

由 Luke Bayliss [email protected] 创建

发布流程

此项目采用一套集成工作流来管理版本、发布和上架：

1. 版本升级标签：每个提交到 main 分支的 PR 都应且只能包含一个版本升级标签：

   • patch - 用于向后兼容的错误修复
   • minor - 用于向后兼容的新功能
   • major - 用于不兼容的变更
   • 如果未指定标签，默认应用 patch

2. 顺序工作流：集成的发布和上架工作流由三个按顺序执行的作业组成：

   • 作业 1：版本升级 - 更新 package.json 中的版本并创建 git 标签
   • 作业 2：创建发布 - 创建包含变更日志的 GitHub 发布
   • 作业 3：上架 - 将软件包发布到 npm

3. 自动触发条件：以下情况下会自动运行此工作流：

   • PR 合并到 main 时（使用该 PR 的版本标签）
   • 变更直接推送到 main 时（使用 patch 版本）
   • 通过 GitHub Actions 手动触发时
   • 手动推送标签时（跳过版本升级，仅创建发布并上架）

所有步骤都会在协调运行的工作流中执行，并设置适当的依赖关系以确保可靠性。

PR 要求

所有 PR 都应且只能包含一个版本升级标签（patch、minor 或 major）。如果未指定标签，系统会自动添加默认的 patch 标签。包含多个版本标签的 PR 仍会被阻止合并。

手动管理版本

无需创建 PR，即可手动触发版本升级：

1. 前往 Actions > Version Bump 工作流
2. 点击 "Run workflow"
3. 选择分支和升级类型（patch、minor、major）
4. 点击 "Run workflow"

其余流程（创建发布和上架）将自动执行。