Mcp Dice

🚀 mcp-dice：适用于掷骰子的MCP服务器

mcp-dice是一个基于Model Context Protocol (MCP)的服务器，它允许大型语言模型（LLMs）进行掷骰子操作。该服务器支持标准的骰子符号，能返回单个骰子的结果及其总和，为相关应用场景提供了便捷的骰子模拟功能。

🚀 快速开始

mcp-dice可让大型语言模型轻松实现掷骰子功能，支持标准骰子符号，操作简单便捷。

✨ 主要特性

• 支持标准的骰子符号，如1d20、3d6、2d8+1等。
• 能返回单个骰子的结果及其总和。
• 可与Claude Desktop轻松集成。
• 兼容MCP Inspector，便于调试。

📦 安装指南

通过Smithery安装

要通过Smithery自动安装Dice Roller for Claude Desktop，可执行以下命令：

npx @smithery/cli install mcp-dice --client claude

同时，需确保uv可用，可参考：https://docs.astral.sh/uv/getting-started/installation/

💻 使用示例

基本命令行使用

# 使用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 Desktop配置

位置

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%/Claude/claude_desktop_config.json%

示例

{
"mcpServers": {
"dice": {
"command": "uvx",
"args": ["mcp-dice"]
}
}
}

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

开发和调试

安装开发依赖项

# 克隆仓库
git clone https://github.com/yourusername/mcp-dice
cd mcp-dice

# 安装开发依赖项
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"
]
}
}
}

{
"mcpServers": {
"dice": {
"command": "wsl",
"args": [
"-e",
// 原文档此处未完整，保持原样
]
}
}
}