Mcp Dice
What is Mcp Dice
mcp-dice is a Model Context Protocol (MCP) server that allows Large Language Models (LLMs) to roll dice using standard dice notation, providing both individual rolls and their total sum.
Use cases
Use cases for mcp-dice include tabletop role-playing games (RPGs) for rolling character stats, board games for determining outcomes, and educational tools for teaching probability.
How to use
To use mcp-dice, install it via Smithery with the command npx @smithery/cli install mcp-dice --client claude. Then, you can run it using uvx mcp-dice and send a JSON object with a notation field to get the dice rolls.
Key features
Key features of mcp-dice include support for standard dice notation (e.g., 1d20, 3d6, 2d8+1), returning both individual rolls and their total sum, easy integration with Claude Desktop, and compatibility with MCP Inspector for debugging.
Where to use
mcp-dice can be used in various fields including gaming, simulations, and any application that requires random number generation through dice rolls.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Overview
What is Mcp Dice
mcp-dice is a Model Context Protocol (MCP) server that allows Large Language Models (LLMs) to roll dice using standard dice notation, providing both individual rolls and their total sum.
Use cases
Use cases for mcp-dice include tabletop role-playing games (RPGs) for rolling character stats, board games for determining outcomes, and educational tools for teaching probability.
How to use
To use mcp-dice, install it via Smithery with the command npx @smithery/cli install mcp-dice --client claude. Then, you can run it using uvx mcp-dice and send a JSON object with a notation field to get the dice rolls.
Key features
Key features of mcp-dice include support for standard dice notation (e.g., 1d20, 3d6, 2d8+1), returning both individual rolls and their total sum, easy integration with Claude Desktop, and compatibility with MCP Inspector for debugging.
Where to use
mcp-dice can be used in various fields including gaming, simulations, and any application that requires random number generation through dice rolls.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Content
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
macOS Configuration
{
"mcpServers": {
"dice": {
"command": "uvx",
"args": [
"mcp-dice"
]
}
}
}WSL Configuration
{
"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
macOS configuration (local dev)
{
"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.
Windows (WSL) configuration (local dev)
{
"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.
Dev Tools Supporting MCP
The following are the main code editors that support the Model Context Protocol. Click the link to visit the official website for more information.
