AI导哈

骰子滚动服务

一个MCP服务器，使大型语言模型能够通过标准骰子符号（如1d20）进行骰子滚动，并返回单个滚动结果及其总和。

  • by yamaton
  • Python
  • 本地部署
  • 4 星标
  • 更新于
在 GitHub 查看 yamaton/mcp-dice

使用说明

mcp-dice：一个用于掷骰子的mcp服务器

一种模型上下文协议（MCP）服务器，使大型语言模型（LLM）能够掷骰子。它接受标准骰子符号（例如。， 1d20)并返回单个卷及其总和。

特性

  • 支持标准骰子符号（例如。， 1d20, 3d6, 2d8+1)
  • 返回单个卷和总和
  • 与Claude Desktop轻松集成
  • 与MCP Inspector兼容进行调试

安装

通过Smithery安装

通过以下方式自动安装Claude Desktop的Dice Roller 史密瑟里:

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

制造 uv 可用：https://docs.astral.sh/uv/getting-started/installation/

用法

基本命令行用法

# Using uvx
uvx mcp-dice

输入格式

服务器接受一个JSON对象 notation 字段：

{
  "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.json
  • 窗户： %APPDATA%/Claude/claude_desktop_config.json

例子

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

注：更换 zsh 使用您的登录shell。

开发与调试

安装开发依赖项

# 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检查员 是调试MCP服务器的有用工具。使用npm安装并运行它：

npx @modelcontextprotocol/inspector uvx mcp-dice

Claude桌面开发配置

macOS configuration (local dev) 
{
  "mcpServers": {
    "dice": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "path/to/mcp-dice-repo",
        "mcp-dice"
      ]
    }
  }
}

注：更换 path/to/mcp-dice-repo 文件系统上存储库的路径。

Windows (WSL) configuration (local dev) 
{
  "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文件系统上的存储库路径。

相关 MCP