mcp-dice: Un servidor MCP para tirar dados

👁 insignia de herrería
👁 captura de pantalla

Un servidor de Protocolo de Contexto de Modelo (MCP) que permite a los Modelos de Lenguaje Grandes (LLM) lanzar dados. Acepta la notación de dados estándar (p. ej., 1d20 ) y devuelve tanto las tiradas individuales como su suma.

Características

• Admite notación de dados estándar (por ejemplo, 1d20 , 3d6 , 2d8+1 )

• Devuelve tanto los rollos individuales como la suma total

• Fácil integración con Claude Desktop

• Compatible con MCP Inspector para depuración

Related MCP server: mcp-llm

Instalación

Instalación mediante herrería

Para instalar Dice Roller para Claude Desktop automáticamente a través de Smithery :

npx @smithery/cli install mcp-dice --client claude

Hacer que uv esté disponible: https://docs.astral.sh/uv/getting-started/installation/

Uso

Uso básico de la línea de comandos

# Using uvx
uvx mcp-dice

Formato de entrada

El servidor acepta un objeto JSON con un campo notation :

{
 "notation": "2d6+3"
}

Ejemplos de respuestas:

{
 "rolls": [
 3,
 1
 ],
 "sum": 4,
 "modifier": 3,
 "total": 7,
 "notation": "2d6+3",
 "timestamp": "2024-12-03T16:36:38.926452"
}

Configuración del escritorio de Claude

Ubicación

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Ventanas: %APPDATA%/Claude/claude_desktop_config.json

Ejemplos

{
 "mcpServers": {
 "dice": {
 "command": "uvx",
 "args": ["mcp-dice"]
 }
 }
}

{
 "mcpServers": {
 "dice": {
 "command": "wsl",
 "args": [
 "-e",
 "zsh",
 "-lc",
 "uvx mcp-dice"
 ]
 }
 }
}

Nota: reemplace zsh con su shell de inicio de sesión.

Desarrollo y depuración

Instalación de dependencias de desarrollo

# Clone the repository
git clone https://github.com/yourusername/mcp-dice
cd mcp-dice

# Install development dependencies
uv pip install -e ".[dev]"

Ejecución de pruebas

uv run pytest

Uso del inspector MCP

El Inspector MCP es una herramienta útil para depurar su servidor MCP. Instálelo y ejecútelo con npm:

npx @modelcontextprotocol/inspector uvx mcp-dice

Configuración de escritorio de Claude para desarrollo

{
 "mcpServers": {
 "dice": {
 "command": "uv",
 "args": [
 "run",
 "--directory",
 "path/to/mcp-dice-repo",
 "mcp-dice"
 ]
 }
 }
}

Nota: Reemplace path/to/mcp-dice-repo con la ruta al repositorio en su sistema de archivos.

{
 "mcpServers": {
 "dice": {
 "command": "wsl",
 "args": [
 "-e",
 "zsh",
 "-lc",
 "uv run --directory path/to/mcp-dice-repo mcp-dice"
 ]
 }
 }
}

Nota: Reemplace zsh con su shell de inicio de sesión. Además, reemplace path/to/mcp-dice-repo con la ruta al repositorio en su sistema de archivos WSL.

Maintenance

Resources

• GitHub Repository
Need Help?Related Servers

Tools

• roll_diceA