Dice Roller MCP Server

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

Caractersticas

• ** Lanzamiento de moneda** - Simple cara o cruz, con soporte para mltiples monedas
• ** Notacin estndar de dados** - Soporta notacin como 2d6+3, 1d20-2, etc.
• ** Dados estndar de juegos** - d4, d6, d8, d10, d12, d20, d100
• ** Ventaja/Desventaja** - Mecnica de D&D 5e (tirar dos veces, quedarse con el mayor/menor)
• ** Dados explosivos** - Los dados que sacan el valor mximo se vuelven a tirar
• ** Historial de tiradas** - Mantiene registro de las ltimas 100 tiradas
• ** Gestin de historial** - Ver y limpiar el historial de tiradas

Instalacin

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

pip install -r requirements.txt

Uso

Ejecutar el servidor

python server.py

Configurar en Claude Desktop

Agrega la siguiente configuracin a tu archivo de configuracin de Claude Desktop:

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

{
  "mcpServers": {
    "dice-roller": {
      "command": "python",
      "args": ["/ruta/a/tu/server.py"]
    }
  }
}

Herramientas Disponibles

1. flip_coin

Lanza una o ms monedas.

• Parmetros:
  • num_flips (opcional): Nmero de monedas a lanzar (1-100, por defecto: 1)

2. roll_dice

Tira dados usando notacin estndar.

• Parmetros:
  • notation: Notacin de dados (ej: "2d6+3", "1d20", "3d8-2")

3. roll_standard

Tira dados de juegos estndar.

• Parmetros:
  • die_type: Tipo de dado ("d4", "d6", "d8", "d10", "d12", "d20", "d100")
  • num_dice (opcional): Nmero 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 qudate con el mayor.

• Parmetros:
  • die_size (opcional): Tamao 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 qudate con el menor.

• Parmetros:
  • die_size (opcional): Tamao 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 mximo.

• Parmetros:
  • die_size: Tamao del dado (2-1000)
  • num_dice (opcional): Nmero 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.

• Parmetros:
  • limit (opcional): Nmero de tiradas recientes a mostrar (1-100, por defecto: 10)

8. clear_history

Limpia el historial de tiradas.

Ejemplos de Uso

Tiradas Bsicas

• "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)

Notacin de Dados

El servidor soporta notacin estndar 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 ms 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 caractersticas o mejoras, no dudes en abrir un issue o enviar un pull request.

Licencia

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