mcp-dice

by yamaton

mcp-dice is a Model Context Protocol (MCP) server that allows Large Language Models (LLMs) to roll dice. It accepts standard dice notation and returns individual rolls and their sum.

View on GitHub

Last updated: N/A

What is mcp-dice?

mcp-dice is an MCP server designed to provide dice rolling functionality to Large Language Models. It interprets standard dice notation and provides detailed results, including individual rolls, the sum, and any modifiers.

How to use mcp-dice?

The server accepts a JSON object with a 'notation' field containing the dice notation string (e.g., '2d6+3'). It can be installed via Smithery or run directly using uvx. Configuration examples are provided for Claude Desktop on macOS and WSL.

Key features of mcp-dice

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

Use cases of mcp-dice

Enhancing LLM-based role-playing games
Adding randomness and unpredictability to LLM responses
Simulating events with probabilistic outcomes
Integrating dice rolling into LLM-powered applications

FAQ from mcp-dice

What dice notations are supported?

The server supports standard dice notation, including modifiers (e.g., 1d20, 3d6, 2d8+1).

How do I install mcp-dice?

You can install it via Smithery using the command npx @smithery/cli install mcp-dice --client claude or run it directly using uvx mcp-dice.

How do I configure mcp-dice with Claude Desktop?

Configuration examples are provided in the README for macOS and WSL, showing how to add the server to your claude_desktop_config.json file.

What is MCP Inspector?

MCP Inspector is a tool for debugging MCP servers. You can use it to inspect the requests and responses of your mcp-dice server.

Can I use mcp-dice for development?

Yes, the README provides instructions for installing development dependencies, running tests, and configuring Claude Desktop for local development.