calculator-mcp-server

Öffentlich gehosteter Server: https://calculator.caseyjhand.com/mcp

Tools

Ein Tool für alle mathematischen Operationen:

calculate

Ein einziges Tool, das 100 % des Serverzwecks abdeckt. Der Parameter operation ist standardmäßig auf evaluate gesetzt, sodass der häufigste Fall einfach { expression: "..." } ist.

• Evaluate — Arithmetik, Trigonometrie, Logarithmen, Statistik, Matrizen, komplexe Zahlen, Einheitenumrechnung, Kombinatorik

• Simplify — algebraische Ausdrücke symbolisch reduzieren (z. B. 2x + 3x -> 5 * x). Unterstützt algebraische und trigonometrische Identitäten

• Derivative — symbolische Ableitungen berechnen (z. B. 3x^2 + 2x + 1 -> 6 * x + 2)

• Variablenbereich über den Parameter scope: { "x": 5, "y": 3 }

• Konfigurierbare Genauigkeit für numerische Ergebnisse

• Leere optionale variable- und precision-Werte von formularbasierten MCP-Clients werden als weggelassen behandelt

Related MCP server: pycodemath

Ressourcen

Funktionen

Basiert auf @cyanheads/mcp-ts-core:

• Deklarative Tool-Definitionen — eine Datei pro Tool, das Framework übernimmt Registrierung und Validierung

• Einheitliche Fehlerbehandlung für alle Tools

• Strukturierte Protokollierung mit optionalem OpenTelemetry-Tracing

• Läuft lokal (stdio/HTTP) oder in Docker

Rechnerspezifisch:

• Gehärtete math.js-v15-Instanz — gefährliche Funktionen deaktiviert, Auswertung per vm.runInNewContext() mit Timeout in einer Sandbox ausgeführt

• Keine Authentifizierung erforderlich — alle Operationen sind schreibgeschützt und zustandslos

• Eingabevalidierung: Begrenzung der Ausdruckslänge, Ablehnung von Ausdrucks-Trennzeichen (Semikolons und Zeilenumbrüche), nur numerische Scope-Werte

• Ergebnisvalidierung: blockierte Ergebnistypen (Funktionen, Parser, Ergebnismengen), konfigurierbare maximale Ergebnisgröße

• Scope-Bereinigung: nur numerische Werte, Schutz vor Prototype Pollution (blockierte __proto__, constructor usw.)

Erste Schritte

Öffentlich gehostete Instanz

Eine öffentliche Instanz ist unter https://calculator.caseyjhand.com/mcp verfügbar — keine Installation erforderlich. Richten Sie einen beliebigen MCP-Client über Streamable HTTP darauf aus:

{
  "mcpServers": {
    "calculator-mcp-server": {
      "type": "streamable-http",
      "url": "https://calculator.caseyjhand.com/mcp"
    }
  }
}

Selbst gehostet / Lokal

Fügen Sie eine der folgenden Optionen zu Ihrer MCP-Client-Konfigurationsdatei hinzu:

{
  "mcpServers": {
    "calculator-mcp-server": {
      "type": "stdio",
      "command": "bunx",
      "args": ["@cyanheads/calculator-mcp-server@latest"]
    }
  }
}

Oder mit npx (kein Bun erforderlich):

{
  "mcpServers": {
    "calculator-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@cyanheads/calculator-mcp-server@latest"]
    }
  }
}

Oder mit Docker:

{
  "mcpServers": {
    "calculator-mcp-server": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "MCP_TRANSPORT_TYPE=stdio",
        "ghcr.io/cyanheads/calculator-mcp-server:latest"
      ]
    }
  }
}

Voraussetzungen

• Bun v1.3.0 oder höher

Installation

1. Repository klonen:

git clone https://github.com/cyanheads/calculator-mcp-server.git

2. In das Verzeichnis wechseln:

cd calculator-mcp-server

3. Abhängigkeiten installieren:

bun install

Konfiguration

Siehe .env.example für optionale Sitzungs-, Fortsetzbarkeits-, Protokollierungs- und Telemetrieeinstellungen.

Server ausführen

Lokale Entwicklung

• Produktionsversion erstellen und ausführen:

  bun run build
  bun run start:http   # or start:stdio

• Prüfungen und Tests ausführen:

  bun run devcheck     # Lints, formats, type-checks
  bun run test         # Runs test suite

Docker

docker build -t calculator-mcp-server .
docker run -p 3010:3010 calculator-mcp-server

Das Image verwendet standardmäßig Streamable HTTP auf Port 3010, zustandslose Sitzungen und protokolliert unter /var/log/calculator-mcp-server.

Projektstruktur

Entwicklungsleitfaden

Siehe AGENTS.md oder CLAUDE.md für Entwicklungsrichtlinien und Architekturregeln. Die Kurzfassung:

• Handler werfen Fehler, das Framework fängt sie — kein try/catch in der Tool-Logik

• Verwenden Sie ctx.log für die Protokollierung

• Registrieren Sie neue Tools und Ressourcen in src/index.ts

Mitwirken

Issues und Pull Requests sind willkommen. Führen Sie vor dem Einreichen die Prüfungen aus:

bun run devcheck
bun run test

Lizenz

Apache-2.0 — siehe LICENSE für Details.