MCP Dice

🚀 mcp-dice：適用於擲骰子的MCP服務器

mcp-dice 是一個 Model Context Protocol (MCP) 服務器，允許大型語言模型（LLMs）進行擲骰子操作。它支持標準的骰子符號，能返回單個骰子的結果及其總和，為相關應用提供了便捷的骰子模擬功能。

✨ 主要特性

• 支持標準的骰子符號，如 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 服務器的有用工具。可使用以下命令進行安裝並運行：

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",
        // 原文檔此處未完整，推測後續還有內容
      ]
    }
  }
}