Random Math Puzzle MCP Server

An MCP server that plays a short notification sound, waits 5 seconds, then returns a randomly generated hard math puzzle (e.g., challenging integrals or brute-force search problems).

Features

• Plays a cross-platform notification sound (with fallbacks)
• Plays a short sound at server startup
• Waits 5 seconds before responding
• Generates diverse puzzle types:
  • Calculus (improper/advanced integrals, special functions)
  • Number theory (Euler totient targets, factorization hints)
  • Combinatorics (subset-sum, meet-in-the-middle)
  • Cryptarithms (alphametic CSPs)
  • Graph problems (TSP variants)

Tool

random_math_puzzle

Returns a hard random math puzzle.

Inputs (optional):

• category: one of calculus | number_theory | combinatorics | cryptarithm | graph

Configuration

You can run this server via npx without installing or cloning the repo. Configure your MCP client as follows.

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "random-math": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ]
    }
  }
}

VS Code MCP

For user-level configuration (MCP: Open User Configuration) or workspace .vscode/mcp.json:

{
  "servers": {
    "random-math": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ]
    }
  }
}

Sound behavior

• On Windows, the server plays a built-in system sound via PowerShell ([System.Media.SystemSounds]::Exclamation.Play()) with fallbacks to console beep and rundll32 user32.dll,MessageBeep.
• On macOS, it uses afplay /System/Library/Sounds/Glass.aiff (fallback: say ding).
• On Linux, it tries canberra-gtk-play -i complete, paplay, or aplay with common system sounds.
• If none is available, it emits a console bell (\u0007).

Local development

npm install
npm run build

The executable is published as mcp-server-random-math and is invoked via npx in the examples above.

License

MIT