Reconstitution Calculator MCP

Servidor MCP Reconstitution Calculator

Um pequeno servidor Model Context Protocol com seis ferramentas de matemática laboratorial. Matemática pura, sem chamadas de rede, sem armazenamento de dados. Mesmas fórmulas da extensão de navegador Reconstitution Calculator.

Feito por Peptara Labs (peptaralabs.io)

Ferramentas

Ferramenta	O que faz	Entradas
reconstitution_concentration	Concentração após adicionar diluente a um pó, em mg/mL e mcg/mL, além do volume em mL e µL que contém uma quantidade desejada	powder_amount, powder_unit (mg, mcg, g), diluent_ml, opcional wanted_amount, wanted_unit
convert_units	Converte unidades de massa, volume ou concentração de massa	value, from, to
dilution_c1v1	Resolve C1V1 = C2V2 para o único valor ausente e fornece o volume de diluente a adicionar	quaisquer três de c1, v1, c2, v2
molarity	Massa necessária para uma molaridade, ou molaridade a partir de uma massa	mw, volume, volume_unit, depois molarity e molarity_unit ou mass e mass_unit
percent_solution	Gramas de soluto para uma solução percentual p/v	percent_wv, final_volume_ml
serial_dilution	Concentração em cada tubo, além do volume de transferência e de diluente por tubo	start_conc, factor, steps (1 a 20), volume_per_tube_ml

Unidades suportadas para convert_units:

• Massa: kg, g, mg, mcg, ug, µg, ng
• Volume: L, mL, uL, µL, nL
• Concentração de massa: g/L, mg/mL, mg/L, mcg/mL, ug/mL, µg/mL, mcg/L, ug/L, µg/L, ng/mL

Cada ferramenta verifica suas entradas. Um valor inválido (volume zero, unidade do tipo errado, campos em branco demais) retorna um erro claro em vez de um número.

Instalação

Requer Node.js 18 ou mais recente.

Execute com npx:

npx -y reconstitution-calculator-mcp

Ou execute a partir de uma cópia local:

npm install
npm start

Configuração do Claude Desktop

Adicione isto a claude_desktop_config.json:

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

A partir de uma cópia local, aponte command para o Node:

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

HTTP Streamable

O servidor usa stdio por padrão. Adicione --http para servir HTTP Streamable em /mcp (sem estado, respostas JSON):

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

PORT, HOST e TRANSPORT=http também funcionam como variáveis de ambiente. GET /status retorna uma linha de status. Os arquivos incluídos Dockerfile e smithery.yaml executam o modo HTTP em um contêiner para hospedagem remota.

Exemplo

Entrada para reconstitution_concentration:

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

Resultado: 5 mg/mL (5000 mcg/mL), e 250 mcg estão em 0,05 mL (50 µL).

Testes

npm test

O teste inicia o servidor via stdio e via HTTP com o cliente do SDK MCP, lista as ferramentas, verifica respostas conhecidas para cada ferramenta e executa uma entrada inválida por ferramenta que deve retornar um erro.

Licença

MIT. Apenas para cálculos laboratoriais.