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

$3

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.

$3

Add to your claude_desktop_config.json:

``json
{
"mcpServers": {
"random-math": {
"command": "npx",
"args": [
"-y",
"mcp-server-random-math@0.1.1"
]
}
}
}
`

$3

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

`json
{
"servers": {
"random-math": {
"command": "npx",
"args": [
"-y",
"mcp-server-random-math@0.1.1"
]
}
}
}
`

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

`bash
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