Skip to main content
Glama

Dice Roller MCP Server

by GUEPARD98
readme.md4.34 kB
# 🎲 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: ```bash pip install -r requirements.txt ``` ## 🚀 Uso ### Ejecutar el servidor ```bash python server.py ``` ### 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` ```json { "mcpServers": { "dice-roller": { "command": "python", "args": ["/ruta/a/tu/server.py"] } } } ``` ## 🎲 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": {} } } }

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/GUEPARD98/Servidor_MCP'

If you have feedback or need assistance with the MCP directory API, please join our Discord server