mcp-dice

by yamaton
MIT License
1
  • Apple

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

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

-
security - not tested
A
license - permissive license
-
quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

A MCP server enabling LLMs to roll dice

  1. Features
    1. Installation
      1. Installing via Smithery
    2. Usage
      1. Basic Command Line Usage
      2. Input Format
    3. Claude Desktop Configuration
      1. Location
      2. Examples
    4. Development and Debugging
      1. Installing Development Dependencies
      2. Running Tests
      3. Using MCP Inspector
      4. Claude Desktop Configuration for Development

    Related MCP Servers

    • -
      security
      A
      license
      -
      quality
      MCP server for toolhouse.ai. This does not rely on an external llm unlike the official server.
      Last updated -
      1
      Python
      MIT License
    • A
      security
      A
      license
      A
      quality
      An MCP server that provides LLMs access to other LLMs
      Last updated -
      4
      14
      12
      JavaScript
      MIT License
    • A
      security
      A
      license
      A
      quality
      An MCP server that enables LLMs to perform blockchain operations on the Base network through natural language commands, including wallet management, balance checking, and transaction execution.
      Last updated -
      4
      4
      1
      TypeScript
      MIT License
      • Apple
    • A
      security
      A
      license
      A
      quality
      MCP server implementation that enables LLMs to interact with Rollbar error tracking data, allowing users to list and analyze errors, view occurrences, track deployments, and access project information.
      Last updated -
      13
      256
      2
      TypeScript
      MIT License

    View all related MCP servers

    ID: vzu553gv26