MCP SERVER · OFFICIAL PROJECTGet real random numbers, shuffles and secure tokens instead of ones the model invents.
LABSCO SUMMARY
Ask a model for a random number and you get something that looks random and is not; these tools hand the job to random.randint, random.choices and friends. The two secure tools go through Python's secrets module instead — that is the pair to use for tokens and keys, and the plain ones for simulations, samples and games.
Seven tools over Python's own random and secrets modules — integers, floats, weighted picks, shuffles, samples and cryptographic tokens.
Nothing to authorize. Published on PyPI as random-number-mcp and launched over stdio with uvx; Python 3.10 or newer.
One command — uvx random-number-mcp
USE CASES
Draw k unique entries from the list without replacement, so nobody appears twice.
Choose from a population with per-item weights, repeated as many times as you need.
Produce a hex token from Python's secrets module at the byte length you name.
Get back a new list with the items shuffled, leaving the original untouched.
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
random_choicesChoose k items from population with replacement, optionally weighted.
Args: population: List of items to choose from k: Number of items to choose (default 1) weights: Optional weights for each item (default None for equal weights)
Returns: List of k chosen items
random_floatGenerate a random float between low and high.
Args: low: Lower bound (default 0.0) high: Upper bound (default 1.0)
Returns: Random float between low and high
random_intGenerate a random integer between low and high (inclusive).
Args: low: Lower bound (inclusive) high: Upper bound (inclusive)
Returns: Random integer between low and high
random_sampleChoose k unique items from population without replacement.
Args: population: List of items to choose from k: Number of items to choose
Returns: List of k unique chosen items
random_shuffleReturn a new list with items in random order.
Args: items: List of items to shuffle
Returns: New list with items in random order
secure_random_intGenerate a secure random integer below upper_bound.
Args: upper_bound: Upper bound (exclusive)
Returns: Random integer in range [0, upper_bound)
secure_token_hexGenerate a secure random hex token.
Args: nbytes: Number of random bytes to generate (default 32)
Returns: Hex string containing 2*nbytes characters
BEFORE YOU INSTALL
7 tools when we connected.
CONTEXT COST
Rated by the size of the 7 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Add the block to your client, or run the command directly.
{
"mcpServers": {
"random-number-mcp": {
"command": "uvx",
"args": [
"random-number-mcp"
]
}
}
}uvx random-number-mcpMCP servers
denismaggior8
maxbogo
suxiongye
yamaton