MCP Rand Server

MCP Rand provides a set of random generation utilities you can access from MCP clients. It includes UUIDs, numbers, Gaussian numbers, random strings and passwords, dice rolling, and card drawing, all designed to be called through your MCP client to satisfy a wide range of testing, gaming, and data-generation needs.

How to use

You connect to the MCP Rand server from your MCP client and call its tools by name. Each tool returns a specific kind of random data or a sequence of results. You can combine multiple tools in your workflow to generate test data, simulate dice rolls for games, or draw cards from a deck.

How to install

Prerequisites: ensure you have Node.js installed (version 14 or newer) and npm available on your system.

Install MCP Rand locally in your project:

npm install mcp-rand

Run the MCP Rand CLI directly with npx:

npx mcp-rand

Alternatively, install MCP Rand globally and run it as a local command:

npm install -g mcp-rand
mcp-rand

If you plan to integrate MCP Rand with an MCP client, add a server entry in your client configuration to define how to reach the tool set. Example configuration provided for client usage shows how to reference the MCP Rand server by either CLI or a direct Node invocation.

Configuration and client integration

To integrate with an MCP client, declare the MCP Rand server in your client’s server list. You can access the CLI path or a programmatic path for local execution. The following illustrates how you can reference the server in your client configuration.

{
  "mcpServers": {
    "mcp-rand": {
      "command": "node",
      "args": ["path/to/mcp-rand/build/index.js"],
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

Tools and example usage

Below are the tools you can call and the kinds of results you can expect. Use these names when calling from your MCP client.

Example usage patterns

The following usage patterns show how you might request data from MCP Rand using a client. Replace the client call method with whatever your MCP client provides.

Notes and limitations

Passwords generated are strong locally, but consider using a dedicated password manager for long-term storage and security practices.

Security and best practices

Treat the MCP Rand server as you would any data-generation service: limit access to trusted clients, monitor usage, and rotate any keys or tokens if you expose the service over a network.

Available tools

generate_uuid

Generates RFC 4122 version 4 UUIDs using secure random generation.

generate_random_number

Generates a random integer within an inclusive range you specify with min and max parameters.

generate_gaussian

Produces random numbers following a Gaussian (normal) distribution, normalized to 0-1.

generate_string

Creates a random string with configurable length and character set (alphanumeric, numeric, lowercase, uppercase, or special characters).

generate_password

Generates a strong password with a mix of uppercase, lowercase, numbers, and symbols, ensuring at least one of each type.

roll_dice

Rolls dice using standard notation like 2d6 or 1d20 and returns individual results plus the total.

draw_cards

Draws cards from a standard 52-card deck, returning drawn cards and the remaining deck state.