AI Makerspace MCP Demo Server

Instructions

Implementation Reference

• server.py:19-23 (handler)

  The primary handler for the 'roll_dice' MCP tool. Registered via @mcp.tool() decorator. It instantiates DiceRoller with inputs and returns its string representation containing the roll results.

  @mcp.tool()
  def roll_dice(notation: str, num_rolls: int = 1) -> str:
      """Roll the dice with the given notation"""
      roller = DiceRoller(notation, num_rolls)
      return str(roller)

• dice_roller.py:37-46 (helper)

  The __str__ method of DiceRoller class, which generates the formatted output string for single or multiple rolls by calling roll_dice or roll_multiple.

  def __str__(self):
      if self.num_rolls == 1:
          rolls, kept_rolls = self.roll_dice()
          return f"ROLLS: {', '.join(map(str, rolls))} -> RETURNS: {sum(kept_rolls)}"
      else:
          results = self.roll_multiple()
          result_strs = []
          for i, result in enumerate(results, 1):
              result_strs.append(f"Roll {i}: ROLLS: {', '.join(map(str, result['rolls']))} -> RETURNS: {result['total']}")
          return "\n".join(result_strs)

• dice_roller.py:10-23 (helper)

  Core helper method in DiceRoller that parses dice notation (e.g., 2d20k1), rolls the dice using random.randint, sorts descending, and returns all rolls and kept rolls.

  def roll_dice(self):
      match = self.dice_pattern.match(self.notation)
      if not match:
          raise ValueError("Invalid dice notation")
  
      num_dice = int(match.group(1))
      dice_sides = int(match.group(2))
      keep = int(match.group(4)) if match.group(4) else num_dice
  
      rolls = [random.randint(1, dice_sides) for _ in range(num_dice)]
      rolls.sort(reverse=True)
      kept_rolls = rolls[:keep]
  
      return rolls, kept_rolls

• dice_roller.py:25-36 (helper)

  Helper method to perform multiple rolls when num_rolls > 1, aggregating results with totals.

  def roll_multiple(self):
      """Roll the dice multiple times according to num_rolls"""
      results = []
      for _ in range(self.num_rolls):
          rolls, kept_rolls = self.roll_dice()
          results.append({
              "rolls": rolls,
              "kept": kept_rolls,
              "total": sum(kept_rolls)
          })
      return results

• server.py:19-19 (registration)

  The @mcp.tool() decorator registers the roll_dice function as an MCP tool.

  @mcp.tool()