mcp-dice：用于掷骰子的 MCP 服务器
一个模型上下文协议 (MCP) 服务器，支持大型语言模型 (LLM) 掷骰子。它接受标准骰子符号（例如1d20 ），并返回每次掷骰结果及其和。
特征
支持标准骰子符号（例如
1d20、3d6、2d8+1）返回单个掷骰结果和总和
轻松与 Claude Desktop 集成
兼容 MCP Inspector 进行调试
Related MCP server: MCP LLMS-TXT Documentation Server
安装
通过 Smithery 安装
要通过Smithery自动安装 Dice Roller for Claude Desktop：
npx @smithery/cli install mcp-dice --client claude
使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"
}
Claude桌面配置
地点
macOS：
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows：
%APPDATA%/Claude/claude_desktop_config.json
示例
{
"mcpServers": {
"dice": {
"command": "uvx",
"args": ["mcp-dice"]
}
}
}
{
"mcpServers": {
"dice": {
"command": "wsl",
"args": [
"-e",
"zsh",
"-lc",
"uvx mcp-dice"
]
}
}
}
注意：用您的登录 shell 替换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 检查器
MCP Inspector是一款用于调试 MCP 服务器的实用工具。使用 npm 安装并运行它：
npx @modelcontextprotocol/inspector uvx mcp-dice
Claude 桌面开发配置
{
"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替换为您的登录 shell。另外，请将path/to/mcp-dice-repo替换为您的 WSL 文件系统上的存储库路径。