Mcp Random Number

MCP Random Number Overview

MCP Random Number is an [MCP (Model Context Protocol)]-compatible server that delivers true random numbers sourced from atmospheric noise via random.org. It's designed to help LLMs (like GPT, Claude, etc.) overcome their deterministic nature and generate unbiased, truly random values when needed.

Why Use It?

LLMs often struggle to generate genuinely random numbers due to their pattern-based nature. This server solves that by retrieving randomness from a trusted, entropy-rich source. A test run of 100 random numbers (1–100) generated by several LLMs showed significant distribution bias — unlike this server, which ensures real randomness.

Installation & Setup

1. Clone and build the project:

git clone https://github.com/maxbogo/mcp-random-number.git
cd mcp-random-number
npm install
npm run build

2. Configure it as an MCP server:

Add the following to your config file, replacing /ABSOLUTE/PATH/TO/ with the actual build path:

{
  "mcpServers": {
    "mcp-random-number": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/mcp-random-number/build/index.js"]
    }
  }
}

Bonus

Includes a distribution chart comparing output from popular LLMs vs. this server to visually highlight the importance of using real randomness in AI applications.

MCP Random Number

An MCP (Model Context Protocol) server that provides true random numbers from atmospheric noise via random.org.

Why?

LLMs struggle with generating truly random numbers. This chart shows the distribution bias of 100 random numbers (range 1-100) from 3 popular LLMs:

Installation

1. Copy, Install, Build:

   git clone https://github.com/maxbogo/mcp-random-number.git
   cd mcp-random-number
   npm install
   npm run build
   

2. Connect to the MCP server:

   Add the below json to your configuration with the appropriate /ABSOLUTE/PATH/TO/ value:

   {
     "mcpServers": {
       "mcp-random-number": {
         "command": "node",
         "args": ["/ABSOLUTE/PATH/TO/mcp-random-number/build/index.js"]
       }
     }
   }