MCP

calculate-mcp: Einstiegsanleitung für den MCP-Server für hochpräzise Berechnungen und Binärdaten

Wer häufig hochpräzise Ganzzahloperationen, Bitmanipulationen oder IEEE 754 Float-Zerlegungen durchführt, sollte calculate-mcp ausprobieren – über npx läuft es ohne Installation im MCP-Client, sofern der Client MCP-Server-Konfiguration unterstützt.

Official source · KonghuanSmart/calculate-mcp

Install

{"mcpServers":{"calculate-mcp":{"command":"npx","args":["-y","calculate-mcp"]}}}

Für wen geeignet

  • Für Entwickler, die hochpräzise Ganzzahlarithmetik benötigen: Basierend auf nativem BigInt sind 64-Bit- und 128-Bit-und-größere Ganzzahlen völlig verlustfrei, mit Unterstützung für vorzeichenbehaftete und vorzeichenlose 8/16/32/64-Bit-Zweierkomplementdarstellungen.
  • Für alle, die Low-Level-Debugging, Reverse Engineering oder Protokollanalyse betreiben: Bitoperationen, Byte-Reihenfolge-(Endianness)-Tausch und die Aufschlüsselung von IEEE 754 Float-Layouts lassen sich direkt in einem einzigen MCP-Server erledigen.
  • Für alle, die mehrstufige Berechnungen in einem einzigen Durchlauf verketten wollen: Die batch_calc-Engine für verkettete Stapelausführung referenziert Ergebnisse vorheriger Schritte mit {"$step": index, "field": "..."} – so entfällt das manuelle Kopieren von Zwischenwerten.
  • Wann es nicht passt: Dies ist kein universelles Chat- oder Suchwerkzeug; es läuft auf Node.js und erfordert einen Client, der MCP-Konfiguration im stdio-Modus unterstützt. Das README macht keine Angaben zur Eignung für Browser oder Umgebungen ohne Node.js – das ist unbestätigt.

Erster Versuch in 3 Minuten

Voraussetzung: Node.js ist lokal installiert und Ihr MCP-Client unterstützt die mcpServers-Konfiguration (das README liefert das Konfigurationsformat).

Empfohlener Hauptweg (im README als „Option A, Recommended“ bezeichnet): Fügen Sie in die Client-Konfiguration Folgendes ein:

{"mcpServers":{"calculate-mcp":{"command":"npx","args":["-y","calculate-mcp"]}}}

Nach dem Speichern den Client neu starten oder aktualisieren; der Client lädt den Server dann automatisch über npx herunter und startet ihn (stdio-Modus), ganz ohne manuelle Installation.

Für den ersten Aufruf empfiehlt sich eine rein rechenbezogene, schreibgeschützte Fähigkeit, z. B. eine beliebige Ganzzahlkonvertierung mit int_convert oder die Zerlegung einer Gleitkommazahl mit ieee754_convert – dies sind lokale numerische Berechnungen, die keine Dateioperationen oder Übermittlungen an Remote-Dienste beinhalten.

Erfolgssignal: In der Werkzeugliste des Clients erscheinen die von calculate-mcp bereitgestellten Tools (das README nennt insgesamt 29 spezialisierte Tools), und eine Rechenanfrage liefert das korrekte Ergebnis. Bleibt die Werkzeugliste leer, prüfen Sie, ob das Konfigurationsformat des Clients mit dem obigen übereinstimmt.

Zweitrangiger Weg (nur zur Orientierung, nicht der Hauptweg): Das README erwähnt, dass der Server auch lokal im stdio-Modus betrieben werden kann (npm start, zuvor muss TypeScript nach build/ gebaut werden) – geeignet für alle, die den Quellcode ändern oder offline arbeiten möchten.

Hinweis: npx -y ruft ein Paket aus npm ab und führt es aus; beim ersten Ausführen wird es aus dem Netz geladen. Dies ist die im offiziellen README ausdrücklich empfohlene Methode.

Anwendungsfälle

Fall 1: Bitdarstellung einer 128-Bit-Ganzzahl verifizieren. Szenario: Sie prüfen eine Ganzzahl mit mehr als 64 Bit in einem Protokollfeld. Rufen Sie int_convert für eine beliebige Ganzzahlkonvertierung auf, geben Sie Ihre große Zahl ein und geben Sie Zielbasis/Breite an; da im Hintergrund natives BigInt verwendet wird, sind 64-Bit-, 128-Bit- und größere Ganzzahlen völlig verlustfrei, und es werden vorzeichenbehaftete und vorzeichenlose Zweierkomplementdarstellungen mit 8/16/32/64 Bit unterstützt. So können Sie direkt abgleichen, ob die Zweierkomplement-Ausgabe den Erwartungen entspricht.

Fall 2: Mehrstufige Binäranalyse in einem Durchlauf. Szenario: Sie möchten mit derselben Zahl zuerst Bitoperationen ausführen, dann die Byte-Reihenfolge tauschen und anschließend eine IEEE 754-Zerlegung vornehmen. Nutzen Sie batch_calc für die verkettete Stapelausführung: Schreiben Sie alle Schritte in einen einzigen Batch-Aufruf; nachfolgende Schritte referenzieren das Ergebnis des vorherigen Schritts mit {"$step": index, "field": "..."}. Zu erwarten: Ein einziger Aufruf liefert alle Zwischen- und Endergebnisse. Die konkreten Parameternamen der einzelnen Schritte richten sich nach der Schema-Anzeige des jeweiligen Tools in Ihrem Client; das README listet die Parameterdetails der einzelnen Tools nicht im Einzelnen auf – dieser Teil muss zur Laufzeit bestätigt werden.

Nutzungsgrenzen

  • Lese-/Schreibcharakter: Alle genannten Tools sind ausschließlich lokale numerische bzw. Kodierungs-/Dekodierungsberechnungen; das README erwähnt kein Schreiben von Dateien, keine Übermittlung an das Netz und keine Kontenoperationen und enthält auch keine Aussage zu Rückgängig-Machung – es darf daher keine „Widerrufbarkeit“ behauptet werden.
  • Zugangsdaten: Keine; die Konfiguration enthält keine Schlüssel oder Tokens.
  • Voraussetzungen: Node.js-Umgebung; die Implementierung besteht aus reinem TypeScript + Node.js-Standardbibliothek + Zod, ohne schwere native Abhängigkeiten.
  • Offizielle Einschränkungen: Das README liefert keine Angaben zu Ratenlimits, Berechtigungsgrenzen oder Datenschutz – diese zentralen Informationen sind unbestätigt; bei der Nutzung sollten keinerlei Annahmen über Datenschutzgrenzen gemacht werden.
  • Noch unbestätigt: die vollständige Parameterliste jedes Tools, die Betriebssystem-Kompatibilität sowie die konkrete Versionsnummer des npx-Pakets.