mcp-dice

mcp-dice: Un servidor MCP para lanzar dados

Un servidor de Protocolo de Contexto de Modelo (MCP) que permite a los Modelos de Lenguaje de Gran Tamaño (LLMs) lanzar dados. Acepta notación estándar de dados (p. ej., 1d20) y devuelve tanto los lanzamientos individuales como su suma.

Características

• Soporta notación estándar de dados (p. ej., 1d20, 3d6, 2d8+1)
• Devuelve tanto los lanzamientos individuales como la suma total
• Integración sencilla con Claude Desktop
• Compatible con MCP Inspector para depuración

Instalación

Instalación mediante Smithery

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

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

Asegúrate de que uv esté disponible: https://docs.astral.sh/uv/getting-started/installation/

Uso

Uso básico desde 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 de Claude Desktop

Ubicación

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %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"
      ]
    }
  }
}

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 de MCP Inspector

El MCP Inspector es una herramienta útil para depurar tu servidor MCP. Instálalo y ejecútalo usando npm:

npx @modelcontextprotocol/inspector uvx mcp-dice

Configuración de Claude Desktop para desarrollo

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

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