Skip to main content
Glama
mcp-dice

mcp-dice

by yamaton

mcp-dice: 주사위 굴리기용 MCP 서버

대장간 배지 스크린샷

대규모 언어 모델(LLM)이 주사위를 굴릴 수 있도록 하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 표준 주사위 표기법(예: 1d20 )을 사용하며, 개별 주사위 굴림 결과와 그 합을 반환합니다.

특징

  • 표준 주사위 표기법(예: 1d20 , 3d6 , 2d8+1 )을 지원합니다.

  • 개별 롤과 총합을 모두 반환합니다.

  • Claude Desktop과의 간편한 통합

  • 디버깅을 위한 MCP Inspector와 호환

Related MCP server: Globalping

설치

Smithery를 통해 설치

Smithery 를 통해 Claude Desktop용 Dice Roller를 자동으로 설치하려면:

지엑스피1

uv 사용 가능하게 설정하세요: https://docs.astral.sh/uv/getting-started/installation/

용법

기본 명령줄 사용법

# Using uvx
uvx mcp-dice

입력 형식

서버는 notation 필드가 있는 JSON 객체를 허용합니다.

{
  "notation": "2d6+3"
}

응답 예시:

{
  "rolls": [
    3,
    1
  ],
  "sum": 4,
  "modifier": 3,
  "total": 7,
  "notation": "2d6+3",
  "timestamp": "2024-12-03T16:36:38.926452"
}

클로드 데스크톱 구성

위치

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • 윈도우: %APPDATA%/Claude/claude_desktop_config.json

예시

{
  "mcpServers": {
    "dice": {
      "command": "uvx",
      "args": ["mcp-dice"]
    }
  }
}
{
  "mcpServers": {
    "dice": {
      "command": "wsl",
      "args": [
        "-e",
        "zsh",
        "-lc",
        "uvx mcp-dice"
      ]
    }
  }
}

참고: zsh 로그인 셸로 바꾸세요.

개발 및 디버깅

개발 종속성 설치

# Clone the repository
git clone https://github.com/yourusername/mcp-dice
cd mcp-dice

# Install development dependencies
uv pip install -e ".[dev]"

테스트 실행

uv run pytest

MCP Inspector 사용

MCP Inspector는 MCP 서버 디버깅에 유용한 도구입니다. npm을 사용하여 설치하고 실행하세요.

npx @modelcontextprotocol/inspector uvx mcp-dice

개발을 위한 Claude Desktop 구성

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

참고: path/to/mcp-dice-repo 파일 시스템의 저장소 경로로 바꾸세요.

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

참고: zsh 로그인 셸로 바꾸세요. 또한, path/to/mcp-dice-repo WSL 파일 시스템의 저장소 경로로 바꾸세요.

Available Tools

1 tool
roll_diceA

Roll dice using standard notation (e.g., '2d6+3', '1d20-2')

Inputs: notation (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 1 tool

    Disambiguation5/5

    With only one tool, there is no possibility of ambiguity or overlap between tools. The single tool 'roll_dice' has a clearly distinct purpose that cannot be confused with any other tool in this set.

    Naming Consistency5/5

    The naming follows a consistent verb_noun pattern with 'roll_dice', and since there is only one tool, there is no inconsistency to evaluate. The naming is clear and predictable for this single-tool server.

    Tool Count2/5

    A single tool is generally too few for most server purposes, as it limits functionality and can feel thin. For a dice-rolling server, while the core operation is covered, additional tools like rolling multiple dice types or retrieving roll history could enhance completeness, making the count borderline inappropriate.

    Completeness3/5

    The tool covers the basic dice-rolling functionality well, but there are notable gaps. For example, there are no tools for listing available dice types, saving roll results, or performing statistical analysis on rolls, which could be expected in a more comprehensive dice-rolling domain.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers