I craft unique cereal names, stories, and ridiculously cute Cereal Baby images.

MCP-Dice
Un serveur MCP permettant aux LLMS de rouler des dés
1
Github Watches
4
Github Forks
1
Github Stars
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.
相关推荐
Evaluator for marketplace product descriptions, checks for relevancy and keyword stuffing.
This GPT assists in finding a top-rated business CPA - local or virtual. We account for their qualifications, experience, testimonials and reviews. Business operators provide a short description of your business, services wanted, and city or state.
I find academic articles and books for research and literature reviews.
Confidential guide on numerology and astrology, based of GG33 Public information
Professional Flask/SQLAlchemy code guide. Follow: https://x.com/navid_re
Découvrez la collection la plus complète et la plus à jour de serveurs MCP sur le marché. Ce référentiel sert de centre centralisé, offrant un vaste catalogue de serveurs MCP open-source et propriétaires, avec des fonctionnalités, des liens de documentation et des contributeurs.
Manipulation basée sur Micropython I2C de l'exposition GPIO de la série MCP, dérivée d'Adafruit_MCP230XX
Une passerelle API unifiée pour intégrer plusieurs API d'explorateur de blockchain de type étherscan avec la prise en charge du protocole de contexte modèle (MCP) pour les assistants d'IA.
Reviews

user_qmk4Hevj
The mcp-dice by yamaton is an outstanding tool for anyone who loves integrating dice mechanics into their applications. This program is well-coded and highly reliable, providing a seamless experience with its straightforward interface. The documentation is thorough, making it user-friendly even for beginners. Check it out on their GitHub page – you won't be disappointed!