MCP 服务器

mcp-dice

一个 MCP 服务器，使 LLM 能够掷骰子。 (Yī gè MCP fúwùqì, shǐ LLM nénggòu zhì shǎizi.)

Tools

roll_dice

Roll dice using standard notation (e.g., '2d6+3', '1d20-2')

README

mcp-dice: 用于掷骰子的 MCP 服务器

screenshot

一个模型上下文协议 (MCP) 服务器，使大型语言模型 (LLM) 能够掷骰子。它接受标准的骰子表示法（例如，1d20），并返回单个掷骰结果及其总和。

特性

支持标准的骰子表示法（例如，1d20、3d6、2d8+1）
返回单个掷骰结果和总和
易于与 Claude Desktop 集成
兼容 MCP Inspector 以进行调试

安装

通过 Smithery 安装

要通过 Smithery 自动为 Claude Desktop 安装 Dice Roller：

npx @smithery/cli install mcp-dice --client claude

确保 uv 可用：https://docs.astral.sh/uv/getting-started/installation/

用法

基本命令行用法

# 使用 uvx
uvx mcp-dice

输入格式

服务器接受带有 notation 字段的 JSON 对象：

{
  "notation": "2d6+3"
}

示例响应：

{
  "rolls": [
    3,
    1
  ],
  "sum": 4,
  "modifier": 3,
  "total": 7,
  "notation": "2d6+3",
  "timestamp": "2024-12-03T16:36:38.926452"
}

Claude Desktop 配置

位置

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json

示例

<details> <summary>macOS 配置</summary>

{
  "mcpServers": {
    "dice": {
      "command": "uvx",
      "args": ["mcp-dice"]
    }
  }
}

</details>

{
  "mcpServers": {
    "dice": {
      "command": "wsl",
      "args": [
        "-e",
        "zsh",
        "-lc",
        "uvx mcp-dice"
      ]
    }
  }
}

注意：将 zsh 替换为您的登录 shell。 </details>

开发和调试

安装开发依赖项

# 克隆存储库
git clone https://github.com/yourusername/mcp-dice
cd mcp-dice

# 安装开发依赖项
uv pip install -e ".[dev]"

运行测试

uv run pytest

使用 MCP Inspector

MCP Inspector 是一个用于调试 MCP 服务器的有用工具。使用 npm 安装并运行它：

npx @modelcontextprotocol/inspector uvx mcp-dice

Claude Desktop 开发配置

<details> <summary>macOS 配置（本地开发）</summary>

{
  "mcpServers": {
    "dice": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "path/to/mcp-dice-repo",
        "mcp-dice"
      ]
    }
  }
}

注意：将 path/to/mcp-dice-repo 替换为文件系统中存储库的路径。 </details>

<details> <summary>Windows (WSL) 配置（本地开发）</summary>

{
  "mcpServers": {
    "dice": {
      "command": "wsl",
      "args": [
        "-e",
        "zsh",
        "-lc",
        "uv run --directory path/to/mcp-dice-repo mcp-dice"
      ]
    }
  }
}