mcp-dice: サイコロを振るためのMCPサーバー

鍛冶屋のバッジスクリーンショット

大規模言語モデル（LLM）がサイコロを振れるようにするモデルコンテキストプロトコル（MCP）サーバー。標準的なサイコロ表記（例： 1d20 ）を受け付け、個々の出目とその合計を返します。

特徴

標準的なサイコロ表記法3d6サポート（例： 1d20``2d8+1 ）
個々のロールと合計の両方を返します
Claude Desktopとの簡単な統合
デバッグ用のMCP Inspectorと互換性あり

Related MCP server: MCP LLMS-TXT Documentation Server

インストール

Smithery経由でインストール

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

入力形式

サーバーは、 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
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"
      ]
    }
  }
}

注: 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ログインシェルに置き換えてください。また、 path/to/mcp-dice-repo WSLファイルシステム上のリポジトリへのパスに置き換えてください。