Reconstitution Calculator MCP

Servidor MCP con seis herramientas de matemáticas de laboratorio: concentración de reconstitución, conversión de unidades, dilución C1V1, molaridad, porcentaje p/v y dilución seriada. Matemáticas puras, sin llamadas de red. Por Peptara Labs.

Documentación

Servidor MCP de Calculadora de Reconstitución

Un pequeño servidor de Protocolo de Contexto de Modelo con seis herramientas de matemáticas de laboratorio. Matemáticas puras, sin llamadas de red, sin datos almacenados. Las mismas fórmulas que la extensión de navegador de Calculadora de Reconstitución.

Hecho por Peptara Labs (peptaralabs.io)

Herramientas

HerramientaQué haceEntradas
reconstitution_concentrationConcentración después de añadir diluyente a un polvo, en mg/mL y mcg/mL, más el volumen en mL y µL que contiene una cantidad deseadapowder_amount, powder_unit (mg, mcg, g), diluent_ml, opcional wanted_amount, wanted_unit
convert_unitsConvierte unidades de masa, volumen o concentración de masavalue, from, to
dilution_c1v1Resuelve C1V1 = C2V2 para el valor faltante y da el volumen de diluyente a añadircualquiera tres de c1, v1, c2, v2
molarityMasa necesaria para una molaridad, o molaridad a partir de una masamw, volume, volume_unit, luego molarity y molarity_unit o mass y mass_unit
percent_solutionGramos de soluto para una solución porcentual p/vpercent_wv, final_volume_ml
serial_dilutionConcentración en cada tubo, más volumen de transferencia y diluyente por tubostart_conc, factor, steps (1 a 20), volume_per_tube_ml

Unidades admitidas para convert_units:

  • Masa: kg, g, mg, mcg, ug, µg, ng
  • Volumen: L, mL, uL, µL, nL
  • Concentración de masa: g/L, mg/mL, mg/L, mcg/mL, ug/mL, µg/mL, mcg/L, ug/L, µg/L, ng/mL

Cada herramienta verifica su entrada. Un valor incorrecto (un volumen cero, una unidad del tipo equivocado, demasiados espacios en blanco) devuelve un error claro en lugar de un número.

Instalación

Requiere Node.js 18 o más reciente.

Ejecútalo con npx:

npx -y reconstitution-calculator-mcp

O ejecútalo desde una copia local:

npm install
npm start

Configuración de Claude Desktop

Añade esto a claude_desktop_config.json:

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

Desde una copia local, apunta command a Node en su lugar:

{
  "mcpServers": {
    "reconstitution-calculator": {
      "command": "node",
      "args": ["/absolute/path/to/mcp/src/index.js"]
    }
  }
}

HTTP Transmisible

El servidor habla stdio por defecto. Añade --http para servir HTTP Transmisible en /mcp (sin estado, respuestas JSON):

node src/index.js --http --port 8081 --host 127.0.0.1

PORT, HOST y TRANSPORT=http también funcionan como variables de entorno. GET /status devuelve una línea de estado. Los incluidos Dockerfile y smithery.yaml ejecutan el modo HTTP en un contenedor para alojamiento remoto.

Ejemplo

Entrada a reconstitution_concentration:

{ "powder_amount": 10, "powder_unit": "mg", "diluent_ml": 2, "wanted_amount": 250, "wanted_unit": "mcg" }

Resultado: 5 mg/mL (5000 mcg/mL), y 250 mcg está en 0.05 mL (50 µL).

Pruebas

npm test

La prueba inicia el servidor sobre stdio y sobre HTTP con el cliente del SDK de MCP, lista las herramientas, verifica respuestas conocidas para cada herramienta y ejecuta una entrada incorrecta por herramienta que debe devolver un error.

Licencia

MIT. Solo para cálculos de laboratorio.