yamaton/mcp-dice

4 stars 6 forks Quality 61 Trend 12MIT

A MCP server enabling LLMs to roll dice

Overview

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. - 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 To install Dice Roller for Claude Desktop automatically via Smithery: Make uv available: https://docs.astral.sh/uv/getting-started/installation/ The server accepts a JSON object with a notation field: - macOS: ~/Library/Application Support/Claude/claude_desktop_config.json - Windows: %APPDATA%/Claude/claude_desktop_config.json Note: Replace zsh with your login shell. The MCP Inspector is a useful tool for debugging your MCP server. Install and run it using npm:

README

mcp-dice: A MCP Server for Rolling 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.

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:

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

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

View the full README on GitHub

Install

uvx mcp-dice

New to MCP? Start with the mcpskill.org guide →

Configuration

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