A
securityA
licenseA
qualityAn MCP server that provides LLMs access to other LLMs
Last updated -
28
66
MIT License
The mcp-dice server allows Large Language Models (LLMs) to roll dice using standard notation (e.g., 1d20, 3d6, 2d8+1, 1d4-1).
Input: Accepts dice notation through a JSON object containing a
notationstringOutput: Returns individual dice roll results, their sum, modifier, and total result
Integration: Easily integrates with Claude Desktop and is compatible with MCP Inspector for debugging
Customization: Supports custom configurations for macOS and Windows (including WSL)
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.jsonWindows:
%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.
local-only server
The server can only run on the client's local machine because it depends on local resources.
Tools
A MCP server enabling LLMs to roll dice
Related MCP Servers
- -securityAlicense-qualityAn MCP server that provides tools to load and fetch documentation from any llms.txt source, giving users full control over context retrieval for LLMs in IDE agents and applications.Last updated -743MIT License
- AsecurityAlicenseAqualityAn MCP server that enables LLMs to interact with Moodle platforms to manage courses, students, assignments, and quizzes through natural language commands.Last updated -717MIT License
- Apache 2.0