mcp-dice

MIT License
1
  • Apple

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: 주사위 굴리기용 MCP 서버

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

특징

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

설치

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

ID: vzu553gv26