Math-MCP

Instructions

Implementation Reference

• build/index.js:150-158 (handler)

  Handler function that executes the 'mode' tool: invokes Statistics.mode on input numbers and returns MCP-formatted text response with mode values and frequency.

  }, async ({ numbers }) => {
      const value = Statistics.mode(numbers);
      return {
          content: [{
                  type: "text",
                  text: `Entries (${value.modeResult.join(', ')}) appeared ${value.maxFrequency} times`
              }]
      };
  });

• build/index.js:148-158 (registration)

  Registration of the 'mode' MCP tool on the mathServer, including name, description, input schema, and handler function.

  mathServer.tool("mode", "Finds the most common number in a list of numbers", {
      numbers: z.array(z.number()).describe("Array of numbers to find the mode of")
  }, async ({ numbers }) => {
      const value = Statistics.mode(numbers);
      return {
          content: [{
                  type: "text",
                  text: `Entries (${value.modeResult.join(', ')}) appeared ${value.maxFrequency} times`
              }]
      };
  });

• build/index.js:149-149 (schema)

  Zod input schema for the 'mode' tool: requires an array of numbers.

  numbers: z.array(z.number()).describe("Array of numbers to find the mode of")

• build/Classes/Statistics.js:39-68 (helper)

  Helper function Statistics.mode that computes the mode(s) of an array: uses Map for frequency count, identifies max frequency, collects all values with that frequency.

  static mode(numbers) {
      const modeMap = new Map();
      //Set each entry parameter into the map and assign it the number of times it appears in the list
      numbers.forEach((value) => {
          if (modeMap.has(value)) {
              modeMap.set(value, modeMap.get(value) + 1);
          }
          else {
              modeMap.set(value, 1);
          }
      });
      //Find the max frequency in the map
      let maxFrequency = 0;
      for (const numberFrequency of modeMap.values()) {
          if (numberFrequency > maxFrequency) {
              maxFrequency = numberFrequency;
          }
      }
      const modeResult = [];
      //Find the entries with the highest frequency
      for (const [key, value] of modeMap.entries()) {
          if (value === maxFrequency) {
              modeResult.push(key);
          }
      }
      return {
          modeResult: modeResult,
          maxFrequency: maxFrequency
      };
  }