Random Generation

🚀 MCP Random Number

MCP Random Number is an MCP server that offers various random generation functions. It supports generating UUIDs compliant with RFC 4122, random numbers, strings, passwords, Gaussian-distributed random numbers, dice rolling, and card drawing.

🚀 Quick Start

MCP Random Number provides a variety of random generation capabilities. You can quickly start using it through installation and basic commands.

✨ Features

• UUID Generator:

  • Complies with RFC 4122 standard.
  • Implemented using Node's crypto module.
  • No parameters required.

• Random Number Generator:

  • Supports generating integers and floating-point numbers.
  • Allows specifying the range and distribution method (uniform, normal, etc.).

• String Generator:

  • Randomly generates strings of a specified length.
  • Supports custom character sets.

• Password Generator:

  • Automatically generates highly secure random passwords.
  • Allows setting password complexity requirements (e.g., including uppercase letters, lowercase letters, numbers, and special symbols).

• Gaussian Distribution Generator:

  • Implemented based on the Box-Muller algorithm.
  • Supports specifying the mean and standard deviation.

• Dice Rolling Simulator:

  • Simulates the process of rolling dice.
  • Allows specifying the number of sides of the dice (e.g., six-sided, eight-sided, etc.).

• Card Drawing Tool:

  • Supports drawing a specified number of cards from a standard deck of playing cards.
  • Keeps track of the remaining number of cards and the current state of the deck.

📦 Installation

You can install MCP Random Number via npm or yarn:

npm install mcp-rand
# or
yarn add mcp-rand

For global installation:

npm install -g mcp-rand

💻 Usage Examples

Basic Usage

Command Line Tool

mcp-rand generate-uuid
# Output example: 36b1ff8e-c2c4-4f70-b5f9-3aee277d20bf

mcp-rand random-number --min 1 --max 10
# Output a random integer between 1 and 10, e.g., 7

mcp-rand string-generator --length 8
# Output example: rF@k9P!q

mcp-rand password-generator --strength strong
# Output a strong password, e.g., $L4fG^2w&5tQ

mcp-rand gaussian-generator --mean 0 --stddev 1
# Output a random number following the standard normal distribution, e.g., -0.34256789

mcp-rand dice-simulator --sides 6
# Simulate rolling a six-sided die and output the result, e.g., 4

mcp-rand draw-cards --count 5
# Output the five drawn cards, the remaining number of cards, and the state of the deck.

MCP Client Integration

const { MCP_rand } = require('mcp-rand');

// Generate UUID
console.log(MCP_rand.generateUUID()); // Output example: 36b1ff8e-c2c4-4f70-b5f9-3aee277d20bf

// Generate random number
console.log(MCP_rand.randomNumber({ min: 1, max: 10 })); // Output a random integer between 1 and 10, e.g., 7

// Generate string
console.log(MCP_rand.generateString({ length: 8 })); // Output example: rF@k9P!q

// Generate password
console.log(MCP_rand.generatePassword({ strength: 'strong' })); // Output a strong password, e.g., $L4fG^2w&5tQ

// Generate Gaussian distribution
console.log(MCP_rand.generateGaussian({ mean: 0, stddev: 1 })); // Output a random number following the standard normal distribution, e.g., -0.34256789

// Simulate dice rolling
console.log(MCP_rand.rollDice({ sides: 6 })); // Simulate rolling a six-sided die and output the result, e.g., 4

// Draw cards
const result1 = MCP_rand.drawCards({ count: 5 });
console.log(result1); // Output the five drawn cards, the remaining number of cards, and the state of the deck.

const result2 = MCP_rand.drawCards({ count: 3, seed: result1.seed });
console.log(result2); // Continue to draw three cards from the same deck.

👥 Contributors

• Alice - Initial implementation
• Bob - Addition of Gaussian distribution function
• Charlie - Improvement of card drawing function

📄 License

MCP Rand is protected by the Apache License 2.0.