dice rolling custom build MCP server

骰子滚轮MCP服务器

一个模型上下文协议（MCP）服务器，为人工智能助手提供全面的掷骰子、抛硬币和D&D机制。

目的

这个MCP服务器为AI助手提供了一个安全的接口，可以执行各种骰子滚动操作，从简单的硬币翻转到复杂的D&D法术伤害计算。

特性

当前实施情况

• roll -使用标准符号掷骰子（1d6、2d10+3等）
• coin_flip -翻转一个或多个硬币
• dnd_ability_scores -使用各种方法生成D&D能力得分
• dnd_spell_damage -使用等级缩放计算D&D法术伤害
• advantage_roll -优势滚动（滚动两次，取更高）
• disadvantage_roll -滚动不利（滚动两次，取较低）
• random_number -在指定范围内生成随机数

先决条件

• 启用MCP工具包的Docker桌面
• Docker MCP CLI插件(docker mcp 命令）

安装

请参阅随文件提供的分步说明。

使用示例

在Claude Desktop中，您可以问：

• “为我的攻击滚d20”
• “翻转3枚硬币”
• “为我的D&D角色生成能力分数”
• “三级火球的滚动伤害”
• “在隐形支票上以优势滚动”
• “给我一个介于1和50之间的随机数”

建筑

Claude Desktop → MCP Gateway → Dice Roller MCP Server
                                        ↓
                                 Random Number Generation

发展

局部测试

# Run directly
python dice_server.py

# Test MCP protocol
echo '{"jsonrpc":"2.0","method":"tools/list","id":1}' | python dice_server.py

添加新工具

1. 将函数添加到dice_server.py
2. 使用@mcp.tool（）进行装饰
3. 用新的工具名称更新目录条目
4. 重建Docker镜像

故障排除

工具未出现

1. 验证Docker镜像构建成功
2. 检查目录和注册表文件
3. 确保Claude Desktop配置包括自定义目录
4. 重新启动克劳德桌面

骰子符号

服务器支持标准骰子符号：

• 1d6 -滚动一个六面模具
• 2d10 -掷两个十面骰子
• 1d20+5 -滚动一个二十面模具，加5
• 3d8-2 -掷三个八面骰子，减去2

D&D功能

能力得分生成

• 4d6下降最低：滚动4d6，放下最低的模具（默认）
• 3d6：直3d6卷
• 积分购买：显示积分购买规则

优势/劣势

• 掷两个骰子，取较高（优势）或较低（劣势）的结果
• 使用修饰符（例如“1d20+5”）

法术伤害

• 根据法术等级自动缩放伤害骰子
• 对火球等法术的特殊处理

安全考虑

• 所有随机化都使用Python的内置随机模块
• 输入验证可防止过度计算
• 以非root用户身份运行
• 无需外部网络访问

许可证

MIT许可证