MCP

calculate-mcp : guide de prise en main du serveur MCP de calcul haute précision et de données binaires

Si vous effectuez fréquemment des calculs entiers en haute précision, des opérations bit à bit ou des décompositions de flottants IEEE 754, calculate-mcp mérite un essai — il s'exécute sans installation dans un client MCP via npx, à condition que votre client prenne en charge la configuration de serveurs MCP.

Official source · KonghuanSmart/calculate-mcp

Install

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

À qui cela s'adresse

  • Les développeurs ayant besoin de calculs entiers en haute précision : basé sur le BigInt natif, il offre une précision zéro-perte pour les entiers de 64 bits, 128 bits et plus, avec prise en charge des représentations en complément à deux signées et non signées sur 8/16/32/64 bits.
  • Ceux qui font du débogage bas niveau, de la rétro-ingénierie ou de l'analyse de protocoles : les opérations bit à bit, les échanges d'ordre des octets (endianness) et la décomposition des flottants IEEE 754 peuvent être réalisés directement au sein d'un seul serveur MCP.
  • Ceux qui souhaitent enchaîner des calculs en plusieurs étapes en une seule exécution : le moteur d'exécution par lots chaîné batch_calc référence les résultats des étapes précédentes avec {"$step": index, "field": "..."}, ce qui évite de copier manuellement les valeurs intermédiaires.
  • Cas où ce n'est pas adapté : ce n'est pas un outil de chat ou de recherche généraliste ; il fonctionne sur Node.js et nécessite que le client prenne en charge une configuration MCP en mode stdio. Le README n'indique pas qu'il convienne aux navigateurs ou aux environnements sans Node, un point non confirmé.

Première tentative en 3 minutes

Prérequis : Node.js est installé sur votre machine et votre client MCP prend en charge la configuration mcpServers (le README fournit ce format de configuration).

Chemin principal recommandé (marqué « Option A, Recommended » dans le README) : ajoutez dans la configuration du client :

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

Après enregistrement, redémarrez ou actualisez le client : celui-ci récupérera et lancera automatiquement le serveur via npx (mode stdio), sans installation manuelle.

Pour un premier appel, privilégiez une capacité de calcul pure et en lecture seule, par exemple une conversion d'entier en précision arbitraire avec int_convert, ou la décomposition d'un flottant avec ieee754_convert — il s'agit de calculs numériques locaux, sans écriture de fichiers ni envoi distant.

Signal de succès : les outils fournis par calculate-mcp apparaissent dans la liste des outils du client (le README décrit 29 outils spécialisés au total) et les requêtes de calcul renvoient des résultats corrects. Si la liste d'outils est vide, vérifiez que le format de configuration du client correspond bien à celui indiqué ci-dessus.

Méthode secondaire (à titre indicatif, ce n'est pas le chemin principal) : le README mentionne la possibilité de l'exécuter localement en mode stdio (npm start, après avoir d'abord compilé le TypeScript vers build/), ce qui convient à ceux qui veulent modifier le code source ou l'exécuter hors ligne.

Remarque : npx -y consiste à récupérer et exécuter un paquet depuis npm ; le premier téléchargement nécessite une connexion réseau. C'est la méthode explicitement recommandée par le README officiel.

Cas d'usage

Cas 1 : vérifier la représentation bit à bit d'un entier de 128 bits. Scénario : vous vérifiez un entier de plus de 64 bits dans un champ de protocole. Appelez int_convert pour une conversion d'entier en précision arbitraire : saisissez votre grand entier et spécifiez la base/la largeur cible ; comme la couche sous-jacente utilise le BigInt natif, les entiers de 64 bits, 128 bits et plus sont traités sans aucune perte de précision, avec prise en charge des représentations en complément à deux signées et non signées sur 8/16/32/64 bits, ce qui vous permet de comparer directement la sortie en complément à deux avec vos attentes.

Cas 2 : analyse binaire en plusieurs étapes enchaînées en une seule fois. Scénario : vous devez effectuer sur le même nombre des opérations bit à bit, puis un échange d'ordre des octets, puis une décomposition IEEE 754. Utilisez l'exécution par lots chaînée batch_calc : écrivez toutes les étapes dans un seul appel par lots, chaque étape ultérieure référençant le résultat de l'étape précédente via {"$step": index, "field": "..."}. Résultat attendu : un seul appel renvoie tous les résultats intermédiaires et finaux ; pour les noms de paramètres exacts de chaque étape, reportez-vous au schéma de l'outil dans votre client — le README ne détaille pas un par un les paramètres de chaque outil, ce point doit être confirmé à l'exécution.

Limites d'utilisation

  • Nature lecture/écriture : tous les outils ci-dessus effectuent des calculs numériques ou de codage/décodage en local ; le README ne mentionne aucune écriture de fichiers, aucun envoi réseau ni aucune opération de compte, et ne propose aucune notion de retour arrière — impossible de prétendre à un quelconque « révocable ».
  • Identifiants : aucun ; la configuration ne contient ni clé ni jeton.
  • Prérequis d'exécution : un environnement Node.js ; l'implémentation repose uniquement sur TypeScript, la bibliothèque standard Node.js et Zod, sans dépendance native lourde.
  • Limitations officielles explicites : le README ne fournit aucune information sur les limites de débit, les frontières de permissions ou la confidentialité des données — ces informations essentielles ne sont pas confirmées et il ne faut faire aucune hypothèse sur les limites de confidentialité lors de l'utilisation.
  • Non encore confirmé : la liste complète des paramètres de chaque outil, la compatibilité avec les systèmes d'exploitation, ainsi que le numéro de version exact du paquet npx.