mcp-dice
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 pytestMCP 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 toolroll_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
Scored across 1 tool
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.
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.
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.
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
Related MCP Connectors
MCP server for AI dialogue using various LLM models via AceDataCloud
MCP server for OpenAI API (chat completions, image generation, embeddings) via AceDataCloud
MCP server for Argo RPG Platform — connects AI assistants to campaign data via OAuth2
Related MCP Servers
- AlicenseBqualityDmaintenanceAn MCP server that provides LLMs access to other LLMs456 npm83MIT

Globalpingofficial
FlicenseNot gradedqualityCmaintenanceRemote MCP server that gives LLMs access to run network commands66-- AlicenseNot gradedqualityCmaintenanceAn MCP server that enables AI agents to act as dynamic dungeon masters for text-based RPGs with dynamically generated rule systems and comprehensive game state management.15MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server enabling AI agents to autonomously play D\&D as players and Dungeon Masters, with real dice rolls and full campaign management.3MIT