@cyanheads/calculator-mcp-server 0.1.6

package/dist/services/math/math-service.js

@@ -0,0 +1,333 @@
+/**
+ * @fileoverview Hardened math.js wrapper for secure expression evaluation.
+ * Creates a restricted math.js instance with dangerous functions disabled in
+ * the expression scope, and wraps evaluation in a vm sandbox with timeout.
+ * @module services/math/math-service
+ */
+import vm from 'node:vm';
+import { invalidParams, serviceUnavailable } from '@cyanheads/mcp-ts-core/errors';
+import { all, create } from 'mathjs';
+/**
+ * Custom simplification rules extending math.js defaults.
+ * math.js ships with algebraic rules only — these add common trig identities.
+ * The `n` wildcard matches any sub-expression (e.g., sin(2x+1)^2).
+ */
+const TRIG_SIMPLIFY_RULES = [
+    // Pythagorean identities
+    'sin(n)^2 + cos(n)^2 -> 1',
+    'cos(n)^2 + sin(n)^2 -> 1',
+    '1 - sin(n)^2 -> cos(n)^2',
+    '1 - cos(n)^2 -> sin(n)^2',
+    // tan / sec / csc / cot relationships
+    'tan(n)^2 + 1 -> sec(n)^2',
+    '1 + tan(n)^2 -> sec(n)^2',
+    'sec(n)^2 - 1 -> tan(n)^2',
+    '1 + cot(n)^2 -> csc(n)^2',
+    'cot(n)^2 + 1 -> csc(n)^2',
+    'csc(n)^2 - 1 -> cot(n)^2',
+    // Double-angle identities
+    '2 * sin(n) * cos(n) -> sin(2 * n)',
+    'cos(n)^2 - sin(n)^2 -> cos(2 * n)',
+];
+/**
+ * Functions disabled in the expression scope for security.
+ * These are overridden via math.import() — expressions cannot call them.
+ * simplify/derivative are called programmatically by the tool handler, not from expressions.
+ */
+const DISABLED_FUNCTIONS = [
+    'import',
+    'createUnit',
+    'evaluate',
+    'parse',
+    'simplify',
+    'derivative',
+    'resolve',
+    'reviver',
+    'compile',
+    'chain',
+    'config',
+    'parser',
+];
+/**
+ * `typed` is NOT disabled here — it's used internally by math.js for function dispatch.
+ * Overriding it breaks trig/simplify/etc. Instead, `typed()` calls from expressions are
+ * caught by the BLOCKED_RESULT_TYPES check (resultType "function" is rejected).
+ */
+/**
+ * Constants/properties overridden in the expression scope to prevent info leakage.
+ * `version` exposes the exact math.js version (enables targeted CVE research).
+ */
+const REDACTED_CONSTANTS = {
+    version: 'redacted',
+};
+/**
+ * Result types that must never be returned to clients.
+ * Function references leak internal source code via toString().
+ * ResultSet indicates multi-expression evaluation (newline bypass).
+ */
+const BLOCKED_RESULT_TYPES = new Set(['function', 'Function', 'ResultSet', 'Parser']);
+/**
+ * Scope key names that could pollute the object prototype chain or shadow
+ * critical Object.prototype methods. Validated before passing to math.js.
+ */
+const BLOCKED_SCOPE_KEYS = new Set([
+    '__proto__',
+    '__defineGetter__',
+    '__defineSetter__',
+    '__lookupGetter__',
+    '__lookupSetter__',
+    'constructor',
+    'prototype',
+    'toString',
+    'valueOf',
+    'hasOwnProperty',
+    'isPrototypeOf',
+    'propertyIsEnumerable',
+    'toLocaleString',
+]);
+/**
+ * Check for expression separators outside square brackets.
+ * Semicolons inside `[...]` are valid matrix row separators.
+ * Newlines (`\n`, `\r`) are also expression separators in math.js.
+ */
+function hasExpressionSeparator(expr) {
+    let depth = 0;
+    for (const ch of expr) {
+        if (ch === '[')
+            depth++;
+        else if (ch === ']')
+            depth--;
+        else if (ch === '\n' || ch === '\r')
+            return true;
+        else if (ch === ';' && depth === 0)
+            return true;
+    }
+    return false;
+}
+export class MathService {
+    evaluate;
+    simplify;
+    derivative;
+    simplifyRules;
+    format;
+    typeOf;
+    config;
+    constructor(config) {
+        this.config = config;
+        // biome-ignore lint/style/noNonNullAssertion: math.js types declare `all` as potentially undefined, but it's always defined at runtime
+        const math = create(all);
+        // Save references before overriding — these bypass the expression scope restrictions
+        this.evaluate = math.evaluate.bind(math);
+        this.simplify = math.simplify.bind(math);
+        this.derivative = math.derivative.bind(math);
+        this.simplifyRules = [...math.simplify.rules, ...TRIG_SIMPLIFY_RULES];
+        this.format = math.format.bind(math);
+        this.typeOf = math.typeOf.bind(math);
+        // Disable dangerous functions in expression scope
+        const disabled = {};
+        for (const fn of DISABLED_FUNCTIONS) {
+            disabled[fn] = () => {
+                throw new Error(`Function "${fn}" is disabled for security.`);
+            };
+        }
+        // Redact constants that leak implementation details
+        for (const [key, value] of Object.entries(REDACTED_CONSTANTS)) {
+            disabled[key] = value;
+        }
+        math.import(disabled, { override: true });
+    }
+    /** Evaluate a math expression with optional variable scope and precision. */
+    evaluateExpression(expression, scope, precision) {
+        this.validateInput(expression);
+        const sanitizedScope = scope ? this.sanitizeScope(scope) : undefined;
+        const raw = this.runWithTimeout(() => sanitizedScope ? this.evaluate(expression, sanitizedScope) : this.evaluate(expression));
+        if (typeof raw === 'number' && !Number.isFinite(raw)) {
+            throw invalidParams(`Expression evaluated to ${raw} — this typically means the operation is mathematically undefined (e.g., division by zero, log of zero). Check the expression.`);
+        }
+        const resultType = this.typeOf(raw);
+        this.validateResultType(resultType);
+        const result = precision != null ? this.format(raw, { precision }) : this.format(raw);
+        this.validateResultSize(result);
+        return { result, resultType };
+    }
+    /** Simplify an algebraic expression symbolically. */
+    simplifyExpression(expression) {
+        this.validateInput(expression);
+        const simplified = this.runWithTimeout(() => this.simplify(expression, this.simplifyRules));
+        const result = simplified.toString();
+        this.validateResultSize(result);
+        return { result, resultType: 'string' };
+    }
+    /** Compute the symbolic derivative of an expression with respect to a variable. */
+    differentiateExpression(expression, variable) {
+        this.validateInput(expression);
+        const derived = this.runWithTimeout(() => this.derivative(expression, variable));
+        const result = derived.toString();
+        this.validateResultSize(result);
+        return { result, resultType: 'string' };
+    }
+    /** Get formatted help content listing available functions, operators, and syntax. */
+    getHelpContent() {
+        return HELP_CONTENT;
+    }
+    validateInput(expression) {
+        if (!expression.trim()) {
+            throw invalidParams('Expression cannot be empty.');
+        }
+        if (expression.length > this.config.maxExpressionLength) {
+            throw invalidParams(`Expression exceeds maximum length of ${this.config.maxExpressionLength} characters.`);
+        }
+        if (hasExpressionSeparator(expression)) {
+            throw invalidParams('Multiple expressions are not allowed. Submit one expression per call.');
+        }
+    }
+    /** Reject scope keys that could pollute the object prototype chain. */
+    sanitizeScope(scope) {
+        for (const key of Object.keys(scope)) {
+            if (BLOCKED_SCOPE_KEYS.has(key)) {
+                throw invalidParams(`Scope key "${key}" is not allowed — it conflicts with a reserved property name.`);
+            }
+        }
+        return scope;
+    }
+    /** Reject result types that leak internals (functions, parsers, multi-expression ResultSets). */
+    validateResultType(resultType) {
+        if (BLOCKED_RESULT_TYPES.has(resultType)) {
+            throw invalidParams(`Expression produced a ${resultType} — only numeric, string, matrix, complex, unit, and boolean results are allowed.`);
+        }
+    }
+    /** Reject results that exceed the configured maximum size. */
+    validateResultSize(result) {
+        if (result.length > this.config.maxResultLength) {
+            throw invalidParams(`Result exceeds maximum size (${this.config.maxResultLength} characters). Reduce matrix dimensions or simplify the expression.`);
+        }
+    }
+    /** Runs a synchronous function inside a vm sandbox with timeout protection. */
+    runWithTimeout(fn) {
+        const sandbox = { fn, result: undefined };
+        const context = vm.createContext(sandbox);
+        try {
+            vm.runInNewContext('result = fn()', context, { timeout: this.config.evaluationTimeoutMs });
+            return sandbox.result;
+        }
+        catch (err) {
+            if (err instanceof Error && 'code' in err && err.code === 'ERR_SCRIPT_EXECUTION_TIMEOUT') {
+                throw serviceUnavailable(`Expression evaluation timed out after ${this.config.evaluationTimeoutMs / 1000} seconds. Simplify the expression or reduce matrix dimensions.`);
+            }
+            // All non-timeout errors from the VM are expression-related
+            const message = err instanceof Error ? err.message : String(err);
+            throw invalidParams(`Invalid expression: ${message}`);
+        }
+    }
+}
+// --- Init/accessor pattern ---
+let _service;
+/** Initialize the math service. Call once from createApp setup(). */
+export function initMathService(config) {
+    _service = new MathService(config);
+}
+/** Get the initialized math service instance. */
+export function getMathService() {
+    if (!_service)
+        throw new Error('MathService not initialized — call initMathService() in setup()');
+    return _service;
+}
+// --- Help content ---
+const HELP_CONTENT = `# Calculator Help
+
+## Operators
+
+| Operator | Description | Example |
+|:---------|:------------|:--------|
+| + | Addition | 2 + 3 |
+| - | Subtraction | 5 - 2 |
+| * | Multiplication | 3 * 4 |
+| / | Division | 10 / 3 |
+| ^ | Exponentiation | 2 ^ 10 |
+| % | Modulus | 17 % 5 |
+| ! | Factorial | 5! |
+
+## Constants
+
+| Name | Value | Description |
+|:-----|:------|:------------|
+| pi | 3.14159... | Ratio of circumference to diameter |
+| e | 2.71828... | Euler's number |
+| phi | 1.61803... | Golden ratio |
+| i | sqrt(-1) | Imaginary unit |
+| Infinity | Infinity | Positive infinity |
+| NaN | NaN | Not a number |
+| true | true | Boolean true |
+| false | false | Boolean false |
+
+## Functions
+
+### Arithmetic
+abs, ceil, floor, round, sign, sqrt, cbrt, exp, expm1, log, log2, log10, log1p, pow, mod, gcd, lcm, nthRoot, hypot, fix, cube, square, unaryMinus, unaryPlus
+
+### Trigonometry
+sin, cos, tan, asin, acos, atan, atan2, sinh, cosh, tanh, asinh, acosh, atanh, sec, csc, cot, asec, acsc, acot, sech, csch, coth
+
+### Statistics
+mean, median, mode, std, variance, min, max, sum, prod, quantileSeq, mad, count
+
+### Matrix
+det, inv, transpose, trace, zeros, ones, identity, diag, size, reshape, flatten, concat, sort, cross, dot, eigs, expm, sqrtm, kron, pinv, range
+
+### Combinatorics
+factorial, gamma, permutations, combinations, catalan, bellNumbers, stirlingS2, composition, multinomial
+
+### Complex Numbers
+re, im, conj, arg, complex
+
+### Logical
+and, or, xor, not
+
+### Comparison
+equal, unequal, larger, largerEq, smaller, smallerEq, compare, deepEqual
+
+### Unit Conversion
+Syntax: \`value unit to targetUnit\`
+
+Common units: m, cm, mm, km, inch, ft, yard, mile, kg, g, lb, oz, s, min, hour, day, celsius, fahrenheit, kelvin, liter, gallon, joule, watt, newton, pascal, bar, psi, radian, degree
+
+## Syntax Examples
+
+### Basic arithmetic
+\`2 + 3 * 4\` => 14
+
+### Functions
+\`sqrt(144)\` => 12
+\`sin(pi / 2)\` => 1
+\`log(1000, 10)\` => 3
+
+### Variables (via scope parameter)
+Provide scope: { "x": 5, "y": 3 }
+Expression: \`x^2 + y\` => 28
+
+### Matrices
+\`[1, 2; 3, 4]\` — 2x2 matrix
+\`det([1, 2; 3, 4])\` => -2
+\`inv([1, 2; 3, 4])\` => [[-2, 1], [1.5, -0.5]]
+
+### Complex numbers
+\`2 + 3i\` => 2 + 3i
+\`sqrt(-4)\` => 2i
+\`abs(3 + 4i)\` => 5
+
+### Unit conversion
+\`5 kg to lbs\` => 11.02 lbs
+\`100 celsius to fahrenheit\` => 212 fahrenheit
+\`1 mile to km\` => 1.60934 km
+
+> **Note:** Unit conversions use IEEE 754 floating-point arithmetic. Results may include minor rounding artifacts (e.g., 211.99999999999997 instead of 212). Use the \`precision\` parameter to round.
+
+### Precision
+Use the precision parameter (1\u201316 significant digits) for numeric results.
+
+### Operations
+- **evaluate** (default): Compute a numeric result
+- **simplify**: Reduce algebraic expressions symbolically (e.g., "2x + 3x" => "5 * x", "sin(x)^2 + cos(x)^2" => 1). Supports algebraic rules and common trigonometric identities (Pythagorean, double-angle, tan/sec/csc/cot relationships).
+- **derivative**: Compute symbolic derivative (requires variable parameter, e.g., variable: "x")
+`;
+//# sourceMappingURL=math-service.js.map

package/dist/services/math/math-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"math-service.js","sourceRoot":"","sources":["../../../src/services/math/math-service.ts"],"names":[],"mappings":"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"}

package/dist/services/math/types.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @fileoverview Types for the math service.
+ * @module services/math/types
+ */
+/** Result of a math operation. */
+export interface MathResult {
+    /** Formatted string representation of the result. */
+    result: string;
+    /** math.js type name: number, BigNumber, Complex, Matrix, Unit, string, boolean. */
+    resultType: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/services/math/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/services/math/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,kCAAkC;AAClC,MAAM,WAAW,UAAU;IACzB,qDAAqD;IACrD,MAAM,EAAE,MAAM,CAAC;IACf,oFAAoF;IACpF,UAAU,EAAE,MAAM,CAAC;CACpB"}

package/dist/services/math/types.js

@@ -0,0 +1,6 @@
+/**
+ * @fileoverview Types for the math service.
+ * @module services/math/types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/services/math/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/services/math/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "@cyanheads/calculator-mcp-server",
+  "version": "0.1.6",
+  "description": "A calculator MCP server that lets any LLM verify mathematical computations. Evaluate, simplify, and differentiate expressions via a single tool. Powered by math.js v15.",
+  "mcpName": "io.github.cyanheads/calculator-mcp-server",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "calculator-mcp-server": "dist/index.js"
+  },
+  "files": ["dist/", "README.md", "LICENSE", "CLAUDE.md", "Dockerfile", "server.json"],
+  "scripts": {
+    "build": "bun scripts/build.ts",
+    "rebuild": "bun scripts/clean.ts && bun scripts/build.ts",
+    "clean": "bun scripts/clean.ts",
+    "devcheck": "bun scripts/devcheck.ts",
+    "tree": "bun scripts/tree.ts",
+    "format": "biome check --write --unsafe .",
+    "lint:mcp": "bun scripts/lint-mcp.ts",
+    "test": "vitest run",
+    "dev:stdio": "MCP_TRANSPORT_TYPE=stdio bun --watch src/index.ts",
+    "dev:http": "MCP_TRANSPORT_TYPE=http bun --watch src/index.ts",
+    "start:stdio": "MCP_TRANSPORT_TYPE=stdio node dist/index.js",
+    "start:http": "MCP_TRANSPORT_TYPE=http node dist/index.js"
+  },
+  "keywords": [
+    "mcp",
+    "mcp-server",
+    "model-context-protocol",
+    "calculator",
+    "math",
+    "mathjs",
+    "llm-tools",
+    "typescript"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cyanheads/calculator-mcp-server.git"
+  },
+  "homepage": "https://github.com/cyanheads/calculator-mcp-server",
+  "bugs": {
+    "url": "https://github.com/cyanheads/calculator-mcp-server/issues"
+  },
+  "author": "cyanheads (https://github.com/cyanheads)",
+  "license": "Apache-2.0",
+  "engines": {
+    "node": ">=22.0.0",
+    "bun": ">=1.2.0"
+  },
+  "packageManager": "bun@1.3.11",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@cyanheads/mcp-ts-core": "^0.2.10",
+    "mathjs": "^15.1.1",
+    "pino-pretty": "^13.1.3"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.4.9",
+    "@types/node": "^25.5.0",
+    "depcheck": "^1.4.7",
+    "ignore": "^7.0.5",
+    "tsc-alias": "^1.8.16",
+    "tsx": "^4.21.0",
+    "typescript": "^6.0.2",
+    "vitest": "^4.1.2"
+  }
+}

package/server.json

@@ -0,0 +1,141 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.cyanheads/calculator-mcp-server",
+  "description": "Calculator MCP server — evaluate, simplify, and differentiate math expressions. Powered by math.js v15.",
+  "repository": {
+    "url": "https://github.com/cyanheads/calculator-mcp-server",
+    "source": "github"
+  },
+  "version": "0.1.6",
+  "packages": [
+    {
+      "registryType": "npm",
+      "registryBaseUrl": "https://registry.npmjs.org",
+      "identifier": "@cyanheads/calculator-mcp-server",
+      "runtimeHint": "bun",
+      "version": "0.1.6",
+      "packageArguments": [
+        {
+          "type": "positional",
+          "value": "run"
+        },
+        {
+          "type": "positional",
+          "value": "start:stdio"
+        }
+      ],
+      "environmentVariables": [
+        {
+          "name": "CALC_MAX_EXPRESSION_LENGTH",
+          "description": "Maximum allowed expression string length.",
+          "format": "string",
+          "isRequired": false,
+          "default": "1000"
+        },
+        {
+          "name": "CALC_EVALUATION_TIMEOUT_MS",
+          "description": "Maximum evaluation time in milliseconds.",
+          "format": "string",
+          "isRequired": false,
+          "default": "5000"
+        },
+        {
+          "name": "CALC_MAX_RESULT_LENGTH",
+          "description": "Maximum result string length in characters.",
+          "format": "string",
+          "isRequired": false,
+          "default": "100000"
+        },
+        {
+          "name": "MCP_LOG_LEVEL",
+          "description": "Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').",
+          "format": "string",
+          "isRequired": false,
+          "default": "info"
+        }
+      ],
+      "transport": {
+        "type": "stdio"
+      }
+    },
+    {
+      "registryType": "npm",
+      "registryBaseUrl": "https://registry.npmjs.org",
+      "identifier": "@cyanheads/calculator-mcp-server",
+      "runtimeHint": "bun",
+      "version": "0.1.6",
+      "packageArguments": [
+        {
+          "type": "positional",
+          "value": "run"
+        },
+        {
+          "type": "positional",
+          "value": "start:http"
+        }
+      ],
+      "environmentVariables": [
+        {
+          "name": "CALC_MAX_EXPRESSION_LENGTH",
+          "description": "Maximum allowed expression string length.",
+          "format": "string",
+          "isRequired": false,
+          "default": "1000"
+        },
+        {
+          "name": "CALC_EVALUATION_TIMEOUT_MS",
+          "description": "Maximum evaluation time in milliseconds.",
+          "format": "string",
+          "isRequired": false,
+          "default": "5000"
+        },
+        {
+          "name": "CALC_MAX_RESULT_LENGTH",
+          "description": "Maximum result string length in characters.",
+          "format": "string",
+          "isRequired": false,
+          "default": "100000"
+        },
+        {
+          "name": "MCP_HTTP_HOST",
+          "description": "The hostname for the HTTP server.",
+          "format": "string",
+          "isRequired": false,
+          "default": "127.0.0.1"
+        },
+        {
+          "name": "MCP_HTTP_PORT",
+          "description": "The port to run the HTTP server on.",
+          "format": "string",
+          "isRequired": false,
+          "default": "3010"
+        },
+        {
+          "name": "MCP_HTTP_ENDPOINT_PATH",
+          "description": "The endpoint path for the MCP server.",
+          "format": "string",
+          "isRequired": false,
+          "default": "/mcp"
+        },
+        {
+          "name": "MCP_AUTH_MODE",
+          "description": "Authentication mode to use: 'none', 'jwt', or 'oauth'.",
+          "format": "string",
+          "isRequired": false,
+          "default": "none"
+        },
+        {
+          "name": "MCP_LOG_LEVEL",
+          "description": "Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').",
+          "format": "string",
+          "isRequired": false,
+          "default": "info"
+        }
+      ],
+      "transport": {
+        "type": "streamable-http",
+        "url": "http://localhost:3010/mcp"
+      }
+    }
+  ]
+}