AI导哈

骰子滚动服务

一个为AI助手提供随机骰子滚动功能的MCP服务器，适用于桌面游戏和模拟场景。

  • by endikoci02
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 endikoci02/dice-roller-mpc-server

使用说明

骰子滚轮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许可证

相关 MCP