lumin-math

A comprehensive MCP (Model Context Protocol) server providing 148 tools for math, hashing, reverse engineering, coding utilities, game development, matrices, quaternions, noise generation, and more - built with Bun.

Designed for use with Claude Code and any MCP-compatible client.

Install

npm (recommended)

npm install -g lumin-math
lumin-math install

Works with Node.js 18+ out of the box. If Bun is detected, the installer will use it automatically for better performance.

From source (with Bun)

git clone https://github.com/SnowiyQ/lumin-math.git
cd lumin-math
bun install
bun run src/cli.ts install

Options

lumin-math install            # global (~/.claude.json)
lumin-math install --project  # project-scoped (.mcp.json)
lumin-math uninstall          # remove
lumin-math status             # check installation

Then restart Claude Code. Tools will be available as mcp__lumin-math__<tool_name>.

CLI

Interactive menu powered by @clack/prompts - just run lumin-math with no arguments for arrow-key selection.

The CLI auto-detects your runtime. If Bun is installed, it configures the MCP server to use bun for faster startup. Otherwise it uses node.

Tools (148)

Arithmetic (9)

| Tool | Description | |------|-------------| | add | Add two numbers | | subtract | Subtract b from a | | multiply | Multiply two numbers | | divide | Divide a by b | | modulo | Remainder of a divided by b | | power | Raise base to exponent | | sqrt | Square root of a number | | abs | Absolute value | | negate | Negate a number |

Trigonometry (8)

| Tool | Description | |------|-------------| | sin | Sine of angle in radians | | cos | Cosine of angle in radians | | tan | Tangent of angle in radians | | arcsin | Inverse sine, returns radians | | arccos | Inverse cosine, returns radians | | arctan | Inverse tangent, returns radians | | degreesToRadians | Convert degrees to radians | | radiansToDegrees | Convert radians to degrees |

Statistics (8)

| Tool | Description | |------|-------------| | sum | Sum of an array of numbers | | mean | Arithmetic mean of an array | | median | Median of an array | | mode | Most frequent value(s) in an array | | min | Minimum value in an array | | max | Maximum value in an array | | standardDeviation | Population standard deviation | | variance | Population variance |

Rounding (4)

| Tool | Description | |------|-------------| | round | Round to N decimal places | | floor | Round down to nearest integer | | ceiling | Round up to nearest integer | | truncate | Truncate toward zero |

Advanced Math (7)

| Tool | Description | |------|-------------| | log | Logarithm with optional base (default 10) | | ln | Natural logarithm | | factorial | Factorial of a non-negative integer (max 170) | | gcd | Greatest common divisor | | lcm | Least common multiple | | isPrime | Check if a number is prime | | baseConvert | Convert a number between bases (2-36) |

Hashing (6)

| Tool | Description | |------|-------------| | md5 | MD5 hash of a string | | sha1 | SHA-1 hash of a string | | sha256 | SHA-256 hash of a string | | sha512 | SHA-512 hash of a string | | crc32 | CRC32 checksum of a string (returns hex) | | hashHex | Hash raw hex bytes with all algorithms at once |

Reverse Engineering (19)

| Tool | Description | |------|-------------| | hexToDec | Hex string to decimal | | decToHex | Decimal to hex (supports two's complement with bit width) | | hexToBin | Hex to binary string | | binToHex | Binary string to hex | | bitwiseAnd | Bitwise AND of two hex values | | bitwiseOr | Bitwise OR of two hex values | | bitwiseXor | Bitwise XOR of two hex values | | bitwiseNot | Bitwise NOT with specified bit width (8/16/32/64) | | bitShift | Logical bit shift left/right (hex input/output) | | rol | Rotate left | | ror | Rotate right | | byteSwap | Reverse byte order (endianness swap) | | xorData | XOR data with repeating key (both hex-encoded) | | rvaToOffset | RVA to file offset calculation | | offsetToRva | File offset to RVA calculation | | pointerArith | Add or subtract hex offset to/from base address | | structPack | Pack typed values into hex bytes (like Python struct.pack) | | structUnpack | Unpack hex bytes into typed values (like Python struct.unpack) | | patternMatch | Find byte pattern offsets with ?? wildcard support |

Supported struct types: u8, i8, u16le/be, i16le/be, u32le/be, i32le/be, u64le/be, f32le/be, f64le/be

Coding Utilities (14)

| Tool | Description | |------|-------------| | base64Encode | Base64 encode a UTF-8 string | | base64Decode | Decode base64 to UTF-8 string | | hexBase64Encode | Base64 encode raw hex bytes | | hexBase64Decode | Decode base64 to hex string | | urlEncode | URL-encode a string | | urlDecode | URL-decode a string | | uuidGenerate | Generate a v4 UUID | | timestampToDate | Unix timestamp to ISO 8601 date string | | dateToTimestamp | ISO date string to Unix timestamp | | stringToHex | UTF-8 string to hex byte string | | hexToString | Hex byte string to UTF-8 string | | asciiFromCode | ASCII code (0-127) to character info | | asciiFromChar | Character to ASCII code info | | charCodeInfo | Full Unicode character info (decimal, hex, octal, binary) |

Game Development (26)

| Tool | Description | |------|-------------| | lerp | Linear interpolation: a + (b - a) * t | | inverseLerp | Inverse lerp: find t where lerp(a,b,t) = value | | clamp | Clamp value to [min, max] | | mapRange | Remap value from one range to another | | randomRange | Random number in [min, max] (optional integer mode) | | vec2Add | Add two 2D vectors | | vec2Subtract | Subtract two 2D vectors | | vec2Scale | Scale a 2D vector | | vec2Dot | Dot product of two 2D vectors | | vec2Magnitude | Length of a 2D vector | | vec2Normalize | Normalize a 2D vector to unit length | | vec2Distance | Distance between two 2D points | | vec2Angle | Angle between two 2D vectors in degrees | | vec3Add | Add two 3D vectors | | vec3Subtract | Subtract two 3D vectors | | vec3Scale | Scale a 3D vector | | vec3Dot | Dot product of two 3D vectors | | vec3Cross | Cross product of two 3D vectors | | vec3Magnitude | Length of a 3D vector | | vec3Normalize | Normalize a 3D vector to unit length | | vec3Distance | Distance between two 3D points | | vec3Angle | Angle between two 3D vectors in degrees | | hexToRgb | Hex color to RGB | | rgbToHex | RGB to hex color string | | rgbToHsl | RGB to HSL | | hslToRgb | HSL to RGB |

Expression Evaluator (1)

| Tool | Description | |------|-------------| | eval | Evaluate a math expression string (supports +,-,*,/,%,**,pi,e,sqrt,sin,cos,tan,log,ln,abs,floor,ceil,round,min,max,atan2,pow,hypot) |

IEEE 754 (3)

| Tool | Description | |------|-------------| | floatToHex | Convert float to IEEE 754 hex representation (32-bit or 64-bit) | | hexToFloat | Convert IEEE 754 hex to float (32-bit or 64-bit) | | floatInspect | Inspect IEEE 754 float - show sign, exponent, mantissa bits |

Bitfield (10)

| Tool | Description | |------|-------------| | getBit | Get a single bit at position (0-indexed from LSB) | | setBit | Set a single bit to 1 at position | | clearBit | Clear a single bit to 0 at position | | toggleBit | Toggle a bit at position | | extractBits | Extract a range of bits [high:low] (inclusive) | | popcount | Count number of set bits (1s) in a value | | bitLength | Number of bits needed to represent the value | | leadingZeros | Count leading zeros for a given bit width | | trailingZeros | Count trailing zeros | | maskCreate | Create a bitmask of N bits starting at position |

Matrix (7)

| Tool | Description | |------|-------------| | matMultiply | Multiply two matrices | | matTranspose | Transpose a matrix | | matDeterminant | Determinant of a square matrix | | matInverse | Inverse of a square matrix | | matIdentity | Generate NxN identity matrix | | matScale | Multiply all elements by a scalar | | matAdd | Add two matrices |

Quaternion (7)

| Tool | Description | |------|-------------| | quatMultiply | Multiply two quaternions (a * b) | | quatNormalize | Normalize a quaternion to unit length | | quatConjugate | Conjugate of a quaternion (negate xyz) | | quatFromEuler | Create quaternion from Euler angles (degrees, XYZ order) | | quatToEuler | Convert quaternion to Euler angles in degrees (XYZ order) | | quatSlerp | Spherical linear interpolation between two quaternions | | quatFromAxisAngle | Create quaternion from axis and angle (degrees) |

Unit Conversion (5)

| Tool | Description | |------|-------------| | convertLength | Convert length units (mm, cm, m, km, in, ft, yd, mi) | | convertWeight | Convert weight units (mg, g, kg, oz, lb, ton) | | convertTemperature | Convert temperature (C, F, K) | | convertData | Convert data sizes (bits: b/kb/mb/gb/tb, bytes: B/KB/MB/GB/TB) | | convertTime | Convert time units (ms, s, min, h, d, w) |

Network (6)

| Tool | Description | |------|-------------| | ipToInt | Convert IPv4 address to integer | | intToIp | Convert integer to IPv4 address | | subnetCalc | Calculate subnet info from IP and CIDR prefix | | ipInSubnet | Check if an IP is within a subnet (CIDR notation) | | ipToHex | Convert IPv4 address to hex | | hexToIp | Convert hex to IPv4 address |

Noise (3)

| Tool | Description | |------|-------------| | perlinNoise | Perlin noise value at 2D/3D coordinates (returns -1 to 1) | | fbmNoise | Fractal Brownian Motion noise (layered Perlin) | | noiseGrid | Generate a 2D grid of Perlin noise values |

Bezier (5)

| Tool | Description | |------|-------------| | bezierQuadratic | Point on a quadratic Bezier curve at t (2D) | | bezierCubic | Point on a cubic Bezier curve at t (2D) | | bezierTangent | Tangent vector on a cubic Bezier curve at t (2D) | | bezierLength | Approximate length of a cubic Bezier curve (2D) | | bezierEasing | CSS cubic-bezier easing function - returns y for given x |

Architecture

lumin-math/
  src/
    server.ts              # MCP stdio server entry point
    cli.ts                 # Interactive CLI installer
    tools/
      index.ts             # Re-exports all tool modules
      arithmetic.ts        # Basic math operations
      trigonometry.ts      # Trig functions
      statistics.ts        # Statistical operations
      rounding.ts          # Rounding functions
      advanced.ts          # Logarithms, primes, factorials, GCD/LCM
      hashing.ts           # MD5, SHA, CRC32
      reverseEngineering.ts # Hex, bitwise, struct pack/unpack, pattern matching
      coding.ts            # Base64, URL encoding, UUID, timestamps, ASCII
      gamedev.ts           # Vectors, interpolation, colors
      expression.ts        # Math expression evaluator
      ieee754.ts           # Float inspection and conversion
      bitfield.ts          # Bit manipulation helpers
      matrix.ts            # Matrix operations
      quaternion.ts        # Quaternion math
      units.ts             # Unit conversion
      network.ts           # IPv4 utilities
      noise.ts             # Perlin noise generation
      bezier.ts            # Bezier curve math
  package.json
  tsconfig.json

• Works with Node.js 18+ and Bun - auto-detects runtime
• stdio transport - communicates via JSON-RPC over stdin/stdout
• Minimal deps - only @modelcontextprotocol/sdk, zod, and @clack/prompts (CLI only)
• Hashing uses node:crypto (CRC32 is a built-in lookup table)
• All bitwise/RE operations use BigInt for full 64-bit support

Development

# From source with Bun (no build needed)
bun run src/server.ts

# Build for Node.js
bun run build

# Run built version
node dist/server.js

License

MIT