What can you do with this server?

The mcp-dice server allows Large Language Models (LLMs) to roll dice using standard notation (e.g., 1d20, 3d6, 2d8+1, 1d4-1). * Input: Accepts dice notation through a JSON object containing a notation string * Output: Returns individual dice roll results, their sum, modifier, and total result * Integration: Easily integrates with Claude Desktop and is compatible with MCP Inspector for debugging * Customization: Supports custom configurations for macOS and Windows (including WSL)

How do I use mcp-dice?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@mcp-dice roll 2d20 for my character's attack" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

mcp-dice: A MCP Server for Rolling Dice

screenshot

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.

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

Related MCP server: MCP LLMS-TXT Documentation Server

Installation

Installing via Smithery

To install Dice Roller for Claude Desktop automatically via Smithery:

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

Make uv available: https://docs.astral.sh/uv/getting-started/installation/

Usage

Basic Command Line Usage

# Using uvx
uvx mcp-dice

Input Format

The server accepts a JSON object with a notation field:

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

Example responses:

{
  "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

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

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

Note: Replace zsh with your login shell.

Development and Debugging

Installing Development Dependencies

# Clone the repository
git clone https://github.com/yourusername/mcp-dice
cd mcp-dice

# Install development dependencies
uv pip install -e ".[dev]"

Running Tests

uv run pytest

Using MCP Inspector

The MCP Inspector is a useful tool for debugging your MCP server. Install and run it using npm:

npx @modelcontextprotocol/inspector uvx mcp-dice

Claude Desktop Configuration for Development

{
  "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.

{
  "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.