ysd-rysn/random-number-mcp-server
If you are the rightful owner of random-number-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
Random Number MCP Server provides a tool to generate random numbers using the random.org API.
Random Number MCP Server
This project implements a simple Model Context Protocol (MCP) server that provides a tool to generate random numbers using the random.org API.
Overview
This server demonstrates the basic concepts of MCP, including:
- Setting up an MCP server.
- Defining and implementing tools.
- Integrating with an external API.
- Configuring the server for use with MCP clients.
Prerequisites
- Node.js and npm installed.
- An MCP client such as the Claude desktop app.
Project Setup
- Clone the repository:
git clone [repository_url] cd [project_directory] - Install dependencies:
npm install
API
The server uses the random.org API to generate true random numbers. No API key is required for basic usage.
MCP Server Implementation
The server is implemented in index.ts and uses the @modelcontextprotocol/sdk to handle MCP communication.
Tool: get_random_number
This tool retrieves a random integer from the random.org API.
Input Parameters:
max(optional): An integer specifying the maximum value (inclusive) of the random number. Defaults to 100.
Output:
- A string containing the random number.
Server Configuration
The server is configured through the cline_mcp_settings.json file. You need to add an entry for this server, specifying the command to run it:
{
"mcpServers": {
"random-number": {
"command": "node",
"args": ["[path/to/index.js]"],
"env": {}
}
}
}
Replace [path/to/index.js] with the actual path to the compiled index.js file (usually in a build or dist directory after running npm run build).
Running the Server
- Build the server
npm run build - Start the server (this is typically done automatically by the MCP client after configuration).
Usage
Once the server is running and configured, you can use the get_random_number tool through your MCP client.
