mcp-dice

# mcp-dice: A MCP Server for Rolling Dice [](https://smithery.ai/protocol/mcp-dice)  A Model Context Protocol (MCP) server that enables Large Language Models (LLMs) to roll dice. It accepts standard dice notation (e.g., `1d20`) and returns both individual rolls and their sum. <a href="https://glama.ai/mcp/servers/vzu553gv26"><img width="380" height="200" src="https://glama.ai/mcp/servers/vzu553gv26/badge" /></a> ## Features - Supports standard dice notation (e.g., `1d20`, `3d6`, `2d8+1`) - Returns both individual rolls and the total sum - Easy integration with Claude Desktop - Compatible with MCP Inspector for debugging ## Installation ### Installing via Smithery To install Dice Roller for Claude Desktop automatically via [Smithery](https://smithery.ai/protocol/mcp-dice): ```bash npx @smithery/cli install mcp-dice --client claude ``` Make `uv` available: https://docs.astral.sh/uv/getting-started/installation/ ## Usage ### Basic Command Line Usage ```shell # Using uvx uvx mcp-dice ``` ### Input Format The server accepts a JSON object with a `notation` field: ```json { "notation": "2d6+3" } ``` Example responses: ```json { "rolls": [ 3, 1 ], "sum": 4, "modifier": 3, "total": 7, "notation": "2d6+3", "timestamp": "2024-12-03T16:36:38.926452" } ``` ## Claude Desktop Configuration ### Location - macOS: `~/Library/Application Support/Claude/claude_desktop_config.json` - Windows: `%APPDATA%/Claude/claude_desktop_config.json` ### Examples <details> <summary>macOS Configuration</summary> ```json { "mcpServers": { "dice": { "command": "uvx", "args": ["mcp-dice"] } } } ``` </details> <details> <summary>WSL Configuration</summary> ```json { "mcpServers": { "dice": { "command": "wsl", "args": [ "-e", "zsh", "-lc", "uvx mcp-dice" ] } } } ``` Note: Replace `zsh` with your login shell. </details> ## Development and Debugging ### Installing Development Dependencies ```shell # Clone the repository git clone https://github.com/yourusername/mcp-dice cd mcp-dice # Install development dependencies uv pip install -e ".[dev]" ``` ### Running Tests ```shell uv run pytest ``` ### Using MCP Inspector The [MCP Inspector](https://github.com/modelcontextprotocol/inspector) is a useful tool for debugging your MCP server. Install and run it using npm: ```shell npx @modelcontextprotocol/inspector uvx mcp-dice ``` ### Claude Desktop Configuration for Development <details> <summary>macOS configuration (local dev)</summary> ```json { "mcpServers": { "dice": { "command": "uv", "args": [ "run", "--directory", "path/to/mcp-dice-repo", "mcp-dice" ] } } } ``` Note: Replace `path/to/mcp-dice-repo` with the path to the repository on your filesystem. </details> <details> <summary>Windows (WSL) configuration (local dev)</summary> ```json { "mcpServers": { "dice": { "command": "wsl", "args": [ "-e", "zsh", "-lc", "uv run --directory path/to/mcp-dice-repo mcp-dice" ] } } } ``` Note: Replace `zsh` with your login shell. Also, replace `path/to/mcp-dice-repo` with the path to the repository on your WSL filesystem. </details>