Servidor MCP

You have a compact Python MCP server that handles dice rolls, coin flips, and common RPG dice mechanics with a convenient history. It exposes a simple interface you can access from an MCP client to perform standard dice notation, advantage/disadvantage, exploding dice, and more, while keeping a recent history for reference.

How to use

Connect to the server from your MCP client and start issuing commands to perform dice rolls and track results. You can perform basic actions like flipping a coin, rolling standard dice, or parsing standard dice notation such as 2d6+3. You can also request advanced patterns like rolling with advantage or exploding dice, and you can retrieve or clear the roll history.

How to install

Prerequisites you need on your machine: Python 3.8+ and pip for dependency management.

Step 1: Install the required Python packages.

pip install -r requirements.txt

Step 2: Run the server locally.

python server.py

Step 3: If you want to configure an MCP client profile for a desktop app, you can add the following MCP server entry to your client configuration. This uses a local stdio setup to start the server via Python.

{
  "mcpServers": {
    "dice-roller": {
      "command": "python",
      "args": ["server.py"]
    }
  }
}

Available tools

flip_coin

Flips one or more coins and returns heads or tails for each flip.

roll_dice

Rolls dice using standard notation like XdY+Z where X is the number of dice, Y is the number of faces, and Z is an optional modifier.

roll_standard

Rolls standard RPG dice types (d4, d6, d8, d10, d12, d20, d100) with an optional modifier.

roll_advantage

Rolls two dice and takes the higher result (D&D 5e style).

roll_disadvantage

Rolls two dice and takes the lower result (D&D 5e style).

roll_exploding

Rolls dice where maximum results trigger additional rolls (exploding dice).

get_history

Retrieves the most recent roll results from history.

clear_history

Clears the stored history of rolls.