MCP Rand

Instructions

Implementation Reference

• src/handlers/generate-random-number.handler.ts:24-49 (handler)

  The handler function that implements the generate_random_number tool logic, generating a random integer between min (default 0) and max (default 100).

  export const generateRandomNumberHandler = async (
    request: CallToolRequest
  ): Promise<CallToolResult> => {
    const args = request.params.arguments as { min?: number; max?: number };
    const min = args.min ?? 0;
    const max = args.max ?? 100;
  
    if (min > max) {
      throw new McpError(
        ErrorCode.InvalidParams,
        'Min value cannot be greater than max value'
      );
    }
  
    // Generate random number between min and max (inclusive)
    const randomNumber = Math.floor(Math.random() * (max - min + 1)) + min;
    
    return {
      content: [
        {
          type: 'text',
          text: randomNumber.toString()
        }
      ]
    };
  };

• src/handlers/generate-random-number.handler.ts:6-22 (schema)

  Tool specification defining the name, description, and input schema (min and max numbers) for the generate_random_number tool.

  export const toolSpec = {
    name: 'generate_random_number',
    description: 'Generate a random number within a specified range',
    inputSchema: {
      type: 'object' as const,
      properties: {
        min: {
          type: 'number',
          description: 'Minimum value (inclusive). Defaults to 0.',
        },
        max: {
          type: 'number',
          description: 'Maximum value (inclusive). Defaults to 100.',
        },
      },
    }
  };

• src/index.ts:20-20 (registration)

  Registers the generateRandomNumberHandler for the 'generate_random_number' tool in the MCP server registry.

  registry.register('tools/call', 'generate_random_number', generateRandomNumberHandler as Handler);