Install
{"mcpServers":{"calculate-mcp":{"command":"npx","args":["-y","calculate-mcp"]}}}¿Para quién es
- Desarrolladores que necesitan aritmética de precisión arbitraria con enteros: basada en BigInt nativo, los enteros de 64 y 128 bits o más se manejan sin pérdida de precisión, con representación en complemento a dos de 8/16/32/64 bits con y sin signo.
- Quienes hacen depuración a bajo nivel, ingeniería inversa o análisis de protocolos: las operaciones bit a bit, el intercambio de orden de bytes (endianness) y la descomposición de flotantes IEEE 754 se pueden hacer en un mismo servidor MCP.
- Quienes necesiten encadenar varios cálculos en una sola ejecución: el motor de ejecución por lotes batch_calc usa
{"$step": index, "field": "..."}para referenciar el resultado del paso anterior, evitando copiar valores intermedios a mano. - Casos para los que NO sirve: no es una herramienta general de chat ni de búsqueda; se ejecuta en Node.js y requiere un cliente MCP con soporte de configuración en modo stdio. El README no indica que funcione en navegador ni en entornos sin Node, algo que no está confirmado.
Primer intento en 3 minutos
Requisito previo: Node.js instalado en tu equipo y un cliente MCP compatible con la configuración mcpServers (el README proporciona ese formato).
Camino principal recomendado (marcado como Option A, Recommended en el README): añade a la configuración del cliente:
{"mcpServers":{"calculate-mcp":{"command":"npx","args":["-y","calculate-mcp"]}}}
Guarda y reinicia o recarga el cliente; este descargará e iniciará el servidor automáticamente vía npx (modo stdio), sin instalación manual.
Para la primera llamada se recomienda una capacidad de solo lectura y de cálculo puro, por ejemplo usar int_convert para una conversión de enteros de precisión arbitraria, o ieee754_convert para descomponer un número en coma flotante: son cálculos numéricos locales, sin escritura de archivos ni envíos remotos.
Señal de éxito: las herramientas de calculate-mcp aparecen en la lista de herramientas del cliente (el README describe 29 herramientas especializadas en total) y las solicitudes de cálculo devuelven resultados correctos. Si la lista está vacía, revisa que el formato de configuración del cliente coincida con el de arriba.
Vía secundaria (solo como referencia, no es la principal): el README menciona ejecutarlo localmente en modo stdio (npm start, previa compilación del TypeScript a build/), útil para quien quiera modificar el código fuente o ejecutarlo sin conexión.
Nota: npx -y descarga y ejecuta el paquete desde npm; la primera ejecución requiere conexión a internet. Es la forma recomendada explícitamente en el README oficial.
Casos de uso
Caso 1: verificar la representación a nivel de bits de un entero de 128 bits. Escenario: estás comprobando un entero de más de 64 bits en un campo de protocolo. Usa int_convert para la conversión de precisión arbitraria: introduce tu entero grande y especifica la base/anchura de destino; como el motor usa BigInt nativo, los enteros de 64 y 128 bits o más no pierden precisión y admite complemento a dos con y sin signo de 8/16/32/64 bits, así que puedes comparar directamente la salida en complemento a dos con lo esperado.
Caso 2: análisis binario con varios pasos encadenados en una sola llamada. Escenario: necesitas aplicar operaciones bit a bit a un mismo número, luego intercambiar el orden de bytes y luego descomponerlo en IEEE 754. Usa la ejecución por lotes batch_calc: escribe todos los pasos en una única llamada por lotes y referencia los resultados de pasos previos con {"$step": index, "field": "..."}. Resultado esperable: una sola llamada devuelve todos los resultados intermedios y finales; los nombres exactos de los parámetros de cada paso deben confirmarse con el schema de la herramienta en tu cliente, ya que el README no detalla los parámetros de cada herramienta y esa parte debe verificarse en tiempo de ejecución.
Límites de uso
- Naturaleza de lectura/escritura: todas estas herramientas son cálculos locales numéricos o de codificación/decodificación; el README no menciona escritura de archivos, envíos por red ni operaciones de cuenta, tampoco ofrece mecanismos de deshacer, así que no puede afirmarse nada sobre "reversibilidad".
- Credenciales: ninguna; la configuración no contiene claves ni tokens.
- Requisitos de ejecución: entorno Node.js; la implementación es TypeScript puro + librería estándar de Node.js + Zod, sin dependencias pesadas de enlaces nativos.
- Restricciones oficiales explícitas: el README no incluye información sobre límites de tasa, límites de permisos ni privacidad de datos: esa información clave no está confirmada, por lo que no deben suponerse límites de privacidad al usarlo.
- Aún sin confirmar: la lista completa de parámetros de cada herramienta, la compatibilidad con sistemas operativos y el número de versión concreto del paquete npx.