remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

mcp-dice: Un servidor MCP para tirar dados

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

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.

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

Tools

roll_dice

Un servidor MCP que permite a los LLM tirar dados