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

대장간 배지 스크린샷

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

특징

표준 주사위 표기법(예: 1d20 , 3d6 , 2d8+1 )을 지원합니다.
개별 롤과 총합을 모두 반환합니다.
Claude Desktop과의 간편한 통합
디버깅을 위한 MCP Inspector와 호환

Related MCP server: MCP LLMS-TXT Documentation Server

설치

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 파일 시스템의 저장소 경로로 바꾸세요.