zazencodes/random-number-mcp

Essential random number generation utilities from the Python standard library, including pseudorandom and cryptographically secure operations for integers, floats, weighted selections, list shuffling, and secure token generation.
> Looking for the agent skill version? random-number-skills implements the same random number generation strategy as an agent skill instead of an MCP server.
Demo Video
https://github.com/user-attachments/assets/303a441a-2b10-47e3-b2a5-c8b51840e362
Tools
| Tool | Purpose | Python function |
| ------------------- | -------------------------------------------- | --------------------- |
| random_int | Generate random integers | random.randint() |
| random_float | Generate random floats | random.uniform() |
| random_choices | Choose items from a list (optional weights) | random.choices() |
| random_shuffle | Return a new list with items shuffled | random.sample() |
| random_sample | Choose k unique items from population | random.sample() |
| secure_token_hex | Generate cryptographically secure hex tokens | secrets.token_hex() |
| secure_random_int | Generate cryptographically secure integers | secrets.randbelow() |
Setup
Claude Desktop
Add this to your Claude Desktop configuration file:
**macOS**: ~/Library/Application Support/Claude/claude_desktop_config.json
**Windows**: %APPDATA%/Claude/claude_desktop_config.json
Tool Reference
random_int
Generate a random integer between low and high (inclusive).
**Parameters:**
- low (int): Lower bound (inclusive)
- high (int): Upper bound (inclusive)
**Example:**
random_float
Generate a random float between low and high.
**Parameters:**
- low (float, optional): Lower bound (default: 0.0)
- high (float, optional): Upper bound (default: 1.0)
**Example:**
random_choices
Choose k items from a population with replacement, optionally weighted.
**Parameters:**
- population (list): List of items to choose from
- k (int, optional): Number of items to choose (default: 1)
- weights (list, optional): Weights for each item (default: equal weights)
**Example:**
random_shuffle
Return a new list with items in random order.
**Parameters:**
- items (list): List of items to shuffle
**Example:**
random_sample
Choose k unique items from population without replacement.
**Parameters:**
- population (list): List of items to choose from
- k (int): Number of items to choose
**Example:**
secure_token_hex
Generate a cryptographically secure random hex token.
**Parameters:**
- nbytes (int, optional): Number of random bytes (default: 32)
**Example:**
secure_random_int
Generate a cryptographically secure random integer below upper_bound.
**Parameters:**
- upper_bound (int): Upper bound (exclusive)
**Example:**
Security Considerations
This package provides both standard pseudorandom functions (suitable for simulations, games, etc.) and cryptographically secure functions (suitable for tokens, keys, etc.):
- **Standard functions** (random_int, random_float, random_choices, random_shuffle): Use Python's random module - fast but not cryptographically secure