骰子滚轮MCP服务器
一种模型上下文协议（MCP）服务器，为AI助手提供随机掷骰子功能。
目的
此MCP服务器为AI助手提供了一个简单、确定的接口，用于生成模拟桌面骰子滚动的随机数。
特性
当前实施情况
roll_die-滚动一个N边的单模具（默认为标准的6边模具）roll_multiple-一次掷多个骰子，得到总结果和单个结果（例如，2d20为优势）
先决条件
- 启用MCP工具包的Docker桌面
- Docker MCP CLI插件(
docker mcp命令）
安装
🚀 安装指南 此服务器设计为通过标准的Docker MCP网关安装，允许它与其他本地服务器（如Obsidian或本地文件访问）一起运行。
步骤1：克隆和构建 下载标准仓库并构建标准Docker容器镜像。
Bash
克隆https://github.com/endikoci02/dice-roller-mcp.git cd骰子滚轮mcp docker build-t骰子滚轮mcp服务器。
步骤2：注册服务器 您需要告诉标准的本地Docker MCP安装有关此新服务器的信息。
创建或编辑自定义目录：
Windows:%USERPROFILE%.docker\\mcp\\catalogs\\custom.yaml
macOS/Linux：~/.docker/mcp/catalogs/custom.yaml
添加目录条目：将此块添加到custom.yaml（确保缩进正确）：
YAML
版本：2 名称：自定义 显示名称：自定义MCP服务器 注册表： 骰子滚轮： 类型：服务器 图片：骰子滚轮mcp服务器：最新 工具： -名称：roll_die -名称：roll_multiple 元数据： 类别：实用程序
在注册表中启用：打开标准注册表.yaml文件（位于标准目录文件夹上方的一个文件夹中），并在标准注册表项下添加标准服务器：key：
YAML
注册表： 骰子滚轮： 参考：“”
步骤3：配置Claude桌面 更新您的Claude Desktop配置以使用标准Docker网关。
打开配置文件：
Windows：%APPDATA%\\Claude\\Claude_desktop_config.json
macOS：~/库/应用程序支持/Claude/Claude_desktop_config json
确保标准mcp工具包网关在您的mcpServers列表中。 ⚠️ 重要提示：将/PATH/TO/YOUR/HOME替换为实际的绝对主目录路径。
JSON
{ “mcpServers”：{ “mcp工具包网关”：{ “command”：“docker”， “args”：\[ “运行”， “-i”， “-rm”， “-v”，“/var/run/docker.sock:/var/run/dlocker.sock”， “-v”，“/PATH/TO/YOUR/HOME/.docker/mcp:/mcp”， “docker/mcp网关”， “--catalog=/mcp/catalogs/custom.yaml”， “--config=/mcp/config.yaml”， “--registry=/mcp/register.yaml”， “--传输=stdio” \] } } } 完全重新启动克劳德桌面。
##windows安装注意事项：请确保在路径上使用//
验证注册
Bash
docker mcp服务器列表
测试滚动
您可以在终端中使用标准的Docker MCP CLI测试没有Claude的标准服务器：
猛击：
docker mcp调用骰子滚轮滚动'{“侧面”：“20”}' 输出：🎲 滚动d20:15
用法示例
在Claude Desktop中，您可以问：
- “为我滚d20”
- “滚动4d6并降至最低”（AI将使用Roll_multiple并处理结果）
- “抛硬币”（人工智能可以将其解释为滚动d2）
- “火球滚动损伤（8d6）”
建筑
克劳德桌面→ MCP网关→ 骰子滚轮MCP服务器→ Python随机模块
许可证
MIT许可证