MCP Dice

An MCP server that supports standard dice notation, providing dice - rolling functionality for large language models and returning the results and sum of each roll.

Games and gamification Education and learning tools #Dice Rolling #Game Tool #LLM Integration .Python

rating : 2.5 points

downloads : 5.4K

update time : 2025-04-29

Open Site

What is MCP Dice Roller?

MCP Dice Roller is a dice rolling service specifically designed for AI models. It allows AI models to simulate dice rolls in conversations, supporting various common dice combinations and modifiers.

How to use MCP Dice Roller?

You can interact with the server through a simple JSON request, specifying the dice combination (e.g., 2d6+3), and the server will return the roll results and the sum.

Applicable Scenarios

It is very suitable for scenarios that require random number generation, such as role - playing games (RPGs), decision - making aids, and probability teaching demonstrations.

Main Features

Standard Dice Notation

Supports the standard dice notation of XdY±Z, where X is the number of dice, Y is the number of sides, and Z is the modifier.

Detailed Results Return

Returns the individual results of each die, the sum, and the final result (including modifiers).

Claude Integration

Can be easily integrated into Claude Desktop, enabling the AI assistant to have the ability to roll dice.

Advantages

Simple and easy - to - use standard dice notation

Returns detailed results for easy verification and display

Seamless integration with AI models

Lightweight service with fast response

Limitations

Only supports standard dice notation and does not support complex expressions

Requires configuration to integrate with AI models

Does not support saving roll history

How to Use

Install the Service

Install the MCP Dice Roller service through Smithery or manually.

Configure Claude Desktop

Edit the configuration file of Claude Desktop and add the MCP Dice Roller server configuration.

Send a Request

Specify the dice combination through a JSON - formatted request.

Usage Examples

Role - Playing Games

Determine whether an attack hits in role - playing games such as D&D.

Random Decision - Making

Randomly select from multiple options.

Frequently Asked Questions

Which dice notations are supported?

How to check if the service is running normally?

Does it support non - standard dice (e.g., d7)?

Related Resources

MCP Protocol Documentation

Official documentation of the Model Context Protocol

GitHub Repository

Project source code

MCP Inspector Tool

A tool for debugging MCP servers

🚀 mcp-dice: MCP Server for Dice Rolling

A Model Context Protocol (MCP) server that enables large language models (LLMs) to roll dice. It supports standard dice notations (e.g., 1d20) and returns the results of individual dice along with their sum.

screenshot

✨ Features

Support for standard dice notations (e.g., 1d20, 3d6, 2d8+1).
Return the results of individual dice and their sum.
Easy integration with Claude Desktop.
Compatibility with MCP Inspector for debugging.

📦 Installation

Installation via Smithery

To automatically install the Dice Roller for Claude Desktop via Smithery:

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

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

💻 Usage Examples

Basic Command-line Usage

# Use uvx
uvx mcp-dice

Input Format

The server accepts a JSON object containing a notation field:

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

Example response:

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

macOS Configuration

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

WSL Configuration

```json { "mcpServers": { "dice": { "command": "wsl", "args": [ "-e", "zsh", "-lc", "uvx mcp-dice" ] } } } ``` > ⚠️ **Important Note** > > Replace `zsh` with your login shell.

Development and Debugging

Install Development Dependencies

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

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

Run Tests

uv run pytest

Use MCP Inspector

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 (Development)

macOS Configuration (Local Development)

```json { "mcpServers": { "dice": { "command": "uv", "args": [ "run", "--directory", "path/to/mcp-dice-repo", "mcp-dice" ] } } } ``` > ⚠️ **Important Note** > > Replace `path/to/mcp-dice-repo` with the repository path on your file system.

Windows (WSL) Configuration (Local Development)

```json { "mcpServers": { "dice": { "command": "wsl", "args": [ "-e", // The rest of the code here ] } } } ``` // The rest of the README can be completed based on the original content if there are more parts after the "args" in the Windows (WSL) configuration.