Dice Roller MCP Server

🎲 Dice Roller MCP Server

Un servidor MCP simple y limpio para tiradas de dados, lanzamiento de monedas y otras mecánicas de dados para juegos de rol.

🎯 Características

• 🪙 Lanzamiento de moneda - Simple cara o cruz, con soporte para múltiples monedas
• 🎲 Notación estándar de dados - Soporta notación como 2d6+3, 1d20-2, etc.
• 🎮 Dados estándar de juegos - d4, d6, d8, d10, d12, d20, d100
• ⚔️ Ventaja/Desventaja - Mecánica de D&D 5e (tirar dos veces, quedarse con el mayor/menor)
• 💥 Dados explosivos - Los dados que sacan el valor máximo se vuelven a tirar
• 📜 Historial de tiradas - Mantiene registro de las últimas 100 tiradas
• 🧹 Gestión de historial - Ver y limpiar el historial de tiradas

📦 Instalación

1. Clona o descarga este repositorio
2. Instala las dependencias:

🚀 Uso

Ejecutar el servidor

Configurar en Claude Desktop

Agrega la siguiente configuración a tu archivo de configuración de Claude Desktop:

En macOS: ~/Library/Application Support/Claude/claude_desktop_config.json En Windows: %APPDATA%\Claude\claude_desktop_config.json

🎲 Herramientas Disponibles

1. flip_coin

Lanza una o más monedas.

• Parámetros:
  • num_flips (opcional): Número de monedas a lanzar (1-100, por defecto: 1)

2. roll_dice

Tira dados usando notación estándar.

• Parámetros:
  • notation: Notación de dados (ej: "2d6+3", "1d20", "3d8-2")

3. roll_standard

Tira dados de juegos estándar.

• Parámetros:
  • die_type: Tipo de dado ("d4", "d6", "d8", "d10", "d12", "d20", "d100")
  • num_dice (opcional): Número de dados (1-100, por defecto: 1)
  • modifier (opcional): Modificador a agregar (-1000 a 1000, por defecto: 0)

4. roll_advantage

Tira con ventaja (D&D 5e) - tira dos veces y quédate con el mayor.

• Parámetros:
  • die_size (opcional): Tamaño del dado (2-1000, por defecto: 20)
  • modifier (opcional): Modificador a agregar (-1000 a 1000, por defecto: 0)

5. roll_disadvantage

Tira con desventaja (D&D 5e) - tira dos veces y quédate con el menor.

• Parámetros:
  • die_size (opcional): Tamaño del dado (2-1000, por defecto: 20)
  • modifier (opcional): Modificador a agregar (-1000 a 1000, por defecto: 0)

6. roll_exploding

Tira dados explosivos - vuelve a tirar cuando sale el valor máximo.

• Parámetros:
  • die_size: Tamaño del dado (2-1000)
  • num_dice (opcional): Número de dados (1-100, por defecto: 1)
  • modifier (opcional): Modificador a agregar (-1000 a 1000, por defecto: 0)

7. get_history

Obtiene el historial de tiradas recientes.

• Parámetros:
  • limit (opcional): Número de tiradas recientes a mostrar (1-100, por defecto: 10)

8. clear_history

Limpia el historial de tiradas.

📝 Ejemplos de Uso

Tiradas Básicas

• "Lanza una moneda" → flip_coin()
• "Tira 2d6+3" → roll_dice(notation="2d6+3")
• "Tira un d20" → roll_standard(die_type="d20")

Tiradas Avanzadas

• "Tira con ventaja" → roll_advantage()
• "Tira 3d6 explosivos" → roll_exploding(num_dice=3, die_size=6)
• "Muestra las últimas 5 tiradas" → get_history(limit=5)

🎮 Notación de Dados

El servidor soporta notación estándar de dados:

• XdY: Tira X dados de Y caras
• XdY+Z: Tira X dados de Y caras y suma Z
• XdY-Z: Tira X dados de Y caras y resta Z

Ejemplos:

• 1d20: Un dado de 20 caras
• 2d6+3: Dos dados de 6 caras más 3
• 3d8-2: Tres dados de 8 caras menos 2

📜 Historial

El servidor mantiene un historial de las últimas 100 tiradas, incluyendo:

• Timestamp de cada tirada
• Tipo de tirada realizada
• Resultado obtenido

🤝 Contribuir

¡Las contribuciones son bienvenidas! Si tienes ideas para nuevas características o mejoras, no dudes en abrir un issue o enviar un pull request.

📄 Licencia

MIT License - Siéntete libre de usar este código en tus proyectos. log.json { "mcpServers": { "dice-roller": { "command": "python", "args": ["D:\servidor_mcp\server.py"], "env": {} } } }