Metadata-Version: 2.4
Name: quantum-dice-mcp
Version: 0.1.0
Summary: MCP server for rolling dice with quantum random numbers
License-Expression: MIT
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# quantum-dice-mcp

MCP server that rolls dice using **real quantum random numbers** from hardware quantum random number generators.

Sources:
- [Leibniz University Hannover QRNG](https://qrng.physik.uni-hannover.de/)
- [ANU Quantum Random Numbers](https://qrng.anu.edu.au/)

Uses rejection sampling to eliminate modulo bias — every roll is truly uniform.

## Install

```bash
pip install quantum-dice-mcp
```

## Connect to Claude Code

```bash
claude mcp add dice -- quantum-dice-mcp
```

Or add to your project's `.mcp.json`:

```json
{
  "mcpServers": {
    "dice": {
      "command": "quantum-dice-mcp"
    }
  }
}
```

## Tool: `roll_dice`

Rolls dice using standard notation.

| Input | Output |
|-------|--------|
| `d20` | One 20-sided die |
| `3d6` | Three 6-sided dice |
| `2d100` | Two percentile dice |
| `4d8` | Four 8-sided dice |

Returns:

```json
{
  "notation": "3d6",
  "rolls": [4, 2, 6],
  "total": 12,
  "source": "QRNG (LfD)"
}
```

## Run standalone

```bash
quantum-dice-mcp
```

Or:

```bash
python -m quantum_dice_mcp
```

## Zero dependencies

Uses only Python stdlib (`urllib.request`, `json`). No API keys required.

## License

MIT
