Name	Description
No prompts

Name	Description
No resources

Name	Description
No tools

Name	Required	Description	Default
No arguments

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

Installation

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

<details> <summary>macOS Configuration</summary>

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

</details> <details> <summary>WSL Configuration</summary>

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

# 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

<details> <summary>macOS configuration (local dev)</summary>

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

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

mcp-dice

Prompts

Resources

Tools

Server Configuration