Enables deploying the MCP server from a forked repository through Smithery integration.
Utilizes Node.js crypto module for cryptographically secure random number generation, with compatibility for Node.js 18.0.0 or higher.
Available as an npm package for easy installation and integration with MCP clients.
Written in TypeScript with comprehensive type definitions for type safety.
Supports installation via yarn package manager as an alternative to npm.
Plugged.in Random Number Generator MCP Server
A state-of-the-art cryptographically secure random number generator server implementing the Model Context Protocol (MCP). This server provides advanced random number generation capabilities for AI applications, LLMs, and other systems requiring high-quality randomness.
🚀 Features
Cryptographically Secure: Uses Node.js built-in
crypto
module for cryptographically secure pseudorandom number generation (CSPRNG)Multiple Data Types: Generate integers, floats, bytes, UUIDs, strings, booleans, and random choices
Flexible Configuration: Customizable ranges, counts, encodings, and character sets
MCP Compliant: Full compatibility with Model Context Protocol specification including tools and prompts
AI-Friendly Prompts: Built-in prompt to help LLMs understand they should use this server for random generation
Type Safety: Written in TypeScript with comprehensive type definitions
Error Handling: Robust input validation and error reporting
Performance Optimized: Efficient algorithms suitable for high-throughput applications
📦 Installation
Prerequisites
Node.js 18.0.0 or higher
npm or yarn package manager
Install via Desktop Extension (DXT)
For Claude Desktop users, you can install this server as a one-click Desktop Extension:
Download the latest
.dxt
file from the releases pageOpen Claude Desktop
Go to Settings → Developer → MCP Servers
Click "Install from file" and select the downloaded
.dxt
file
Install from npm
Or install locally in your project:
Deploy with Smithery
Deploy this MCP server to the cloud using Smithery:
Fork this repository
Connect your GitHub account to Smithery
Navigate to the Deployments tab
Click "Deploy"
The server includes a smithery.yaml
configuration file for easy deployment.
Build from Source
🛠️ Usage
Running the Server
The server communicates via stdio (standard input/output) following the MCP protocol:
Integration with MCP Clients
For npm installation (recommended):
Add to your MCP client configuration. For Claude Desktop, add to your claude_desktop_config.json
:
This will always use the latest version from npm without requiring a global installation.
For local installation:
🔧 Available Tools
1. Generate Random Integers
Generate cryptographically secure random integers within a specified range.
Parameters:
min
(integer, optional): Minimum value (inclusive), default: 0max
(integer, optional): Maximum value (inclusive), default: 100count
(integer, optional): Number of integers to generate, default: 1, max: 1000
Example:
2. Generate Random Floats
Generate cryptographically secure random floating-point numbers.
Parameters:
min
(number, optional): Minimum value (inclusive), default: 0.0max
(number, optional): Maximum value (exclusive), default: 1.0count
(integer, optional): Number of floats to generate, default: 1, max: 1000precision
(integer, optional): Decimal places to round to, default: 6, max: 15
Example:
3. Generate Random Bytes
Generate cryptographically secure random bytes in various encodings.
Parameters:
length
(integer, optional): Number of bytes to generate, default: 32, max: 1024encoding
(string, optional): Output encoding ("hex", "base64", "binary"), default: "hex"
Example:
4. Generate UUIDs
Generate cryptographically secure UUID version 4 identifiers.
Parameters:
count
(integer, optional): Number of UUIDs to generate, default: 1, max: 100format
(string, optional): UUID format ("standard", "compact"), default: "standard"
Example:
5. Generate Random Strings
Generate cryptographically secure random strings with customizable character sets.
Parameters:
length
(integer, optional): String length, default: 16, max: 256charset
(string, optional): Character set ("alphanumeric", "alphabetic", "numeric", "hex", "base64", "ascii_printable"), default: "alphanumeric"count
(integer, optional): Number of strings to generate, default: 1, max: 100
Example:
6. Generate Random Choices
Randomly select items from a provided list using cryptographically secure randomness.
Parameters:
choices
(array, required): Array of string items to choose fromcount
(integer, optional): Number of items to select, default: 1allow_duplicates
(boolean, optional): Whether to allow duplicate selections, default: true
Example:
7. Generate Random Booleans
Generate cryptographically secure random boolean values with configurable probability.
Parameters:
count
(integer, optional): Number of booleans to generate, default: 1, max: 1000probability
(number, optional): Probability of true (0.0 to 1.0), default: 0.5
Example:
🤖 AI Prompts
The server includes a built-in prompt to help LLMs understand they should use this server for random number generation rather than attempting to generate random values themselves.
Available Prompt: generate_random
This prompt educates the AI about its limitations in generating random numbers and guides it to use the available cryptographically secure tools.
Parameters:
type
(string, optional): Type of random value needed (integer, float, uuid, string, bytes, choice, boolean)requirements
(string, optional): Specific requirements for the random generation
Example Usage: When an LLM receives a request like "Generate a random password" or "Pick a random number", the prompt will:
Acknowledge that LLMs cannot generate truly random values
Explain the available cryptographically secure tools
Guide the AI to use the appropriate tool for the task
This ensures that all random generation in your application uses proper cryptographic methods rather than predictable AI-generated patterns.
🔒 Security Features
This server implements several security best practices:
Cryptographically Secure Randomness: All random number generation uses Node.js
crypto
module functions (randomBytes
,randomInt
,randomUUID
) which provide cryptographically secure pseudorandom numbers suitable for security-sensitive applications.Input Validation: Comprehensive validation of all input parameters to prevent injection attacks and ensure data integrity.
Rate Limiting: Built-in limits on generation counts to prevent resource exhaustion attacks.
Error Handling: Secure error messages that don't leak sensitive information about the system state.
🧪 Testing
The server includes a comprehensive test suite that validates all functionality:
The test suite covers:
Tool discovery and listing
All random generation functions
Input validation and error handling
Output format verification
Statistical properties validation
📊 Performance
The server is optimized for performance while maintaining security:
Efficient Algorithms: Uses optimized native crypto functions
Memory Management: Minimal memory footprint with efficient buffer handling
Concurrent Requests: Thread-safe design supporting multiple simultaneous requests
Scalability: Suitable for high-throughput applications
🔧 Development
Project Structure
Building
Development Mode
Testing with MCP Inspector
You can test the server using the MCP Inspector tool:
This will start the MCP Inspector web interface where you can:
View available tools
Test tool execution
Inspect request/response payloads
Debug server behavior
🤝 Contributing
Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.
Development Guidelines
Follow TypeScript best practices
Maintain comprehensive test coverage
Update documentation for new features
Ensure all tests pass before submitting
Follow semantic versioning for releases
📄 License
This project is licensed under the MIT License - see the LICENSE file for details.
🔗 Related Projects
Model Context Protocol - The official MCP specification
Plugged.in - MCP server management and discovery platform
MCP SDK - Official TypeScript SDK for MCP
📞 Support
For support, questions, or feature requests:
Open an issue on GitHub
Visit the Plugged.in platform for MCP server management
Check the MCP documentation for protocol details
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Tools
Teaching LLMs that Math.random() is so last century
- 🚀 Features
- 📦 Installation
- 🛠️ Usage
- 🔧 Available Tools
- 🤖 AI Prompts
- 🔒 Security Features
- 🧪 Testing
- 📊 Performance
- 🔧 Development
- 🤝 Contributing
- 📄 License
- 🔗 Related Projects
- 📞 Support
Related Resources
Related MCP Servers
- MIT License
- MIT License
- MIT License