CalculatorLib MCP

Instalación en 60 segundos

Elige el cliente que usas, pega el fragmento, reinicia. Eso es todo.

Claude Code Claude Desktop Cursor Zed Cline Windsurf Otro / genérico

claude mcp add --transport http calculatorlib https://calculatorlib.com/mcp

{
  "mcpServers": {
    "calculatorlib": {
      "url": "https://calculatorlib.com/mcp"
    }
  }
}

{
  "mcpServers": {
    "calculatorlib": {
      "url": "https://calculatorlib.com/mcp"
    }
  }
}

{
  "mcpServers": {
    "calculatorlib": {
      "url": "https://calculatorlib.com/mcp"
    }
  }
}

{
  "context_servers": {
    "calculatorlib": {
      "source": "custom",
      "transport": {
        "type": "streamable-http",
        "url": "https://calculatorlib.com/mcp"
      }
    }
  }
}

{
  "mcpServers": {
    "calculatorlib": {
      "url": "https://calculatorlib.com/mcp",
      "transportType": "streamableHttp"
    }
  }
}

{
  "mcpServers": {
    "calculatorlib": {
      "serverUrl": "https://calculatorlib.com/mcp"
    }
  }
}

{
  "transport": "streamable-http",
  "endpoint": "https://calculatorlib.com/mcp"
}

curl -X POST https://calculatorlib.com/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Prueba estas indicaciones

Después de instalar, solo habla con Claude en lenguaje natural — él elige la herramienta adecuada.

Entorno de pruebas en vivo

Llama al servidor aquí mismo — JSON-RPC real a https://calculatorlib.com/mcp, respuestas reales. Sin registro. cargando herramientas…

Explorador de herramientas

Busca en la biblioteca de calculadoras y las 9 categorías de conversores por nombre o título. Útil para descubrir qué pedirle a Claude.

Cómo funciona

• Endpoint: un único manejador POST en https://calculatorlib.com/mcp que habla JSON-RPC 2.0 sobre Streamable HTTP (especificación de transporte 2025-06-18).
• Nombres de herramientas: los slugs de las calculadoras usan snake_case (bmi_calculator, compound_interest_calculator); los conversores son convert_<category>.
• Entradas: cada herramienta publica un JSON Schema derivado de los campos del formulario de la calculadora (tipo, enumeración, mín/máx). Los campos condicionales (p. ej. métrico vs imperial en el IMC) se listan como opcionales — lee la descripción de cada campo para saber qué combinaciones son válidas.
• Salidas: un resumen de texto de una línea más un objeto JSON structuredContent que el LLM puede analizar (p. ej. { "main": [{...}], "data": [...] }).
• Actualizaciones: el catálogo se refresca cada 5 minutos — las calculadoras recién publicadas aparecen automáticamente.

API directa (sin necesidad de cliente MCP)

¿Quieres integrar sin un cliente MCP? Los mismos datos están disponibles mediante simples endpoints JSON.

curl -X POST https://calculatorlib.com/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

curl -X POST https://calculatorlib.com/mcp \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc":"2.0","id":2,"method":"tools/call",
    "params":{
      "name":"bmi_calculator",
      "arguments":{"unitSystem":"metric","weight":70,"height":170}
    }
  }'

curl -X POST https://calculatorlib.com/mcp \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc":"2.0","id":3,"method":"tools/call",
    "params":{
      "name":"convert_length",
      "arguments":{"value":5,"from":"Meter","to":"Foot"}
    }
  }'

Endpoints REST (sin envoltorio JSON-RPC):

• /api/calculators/schemas?q=<keywords> — buscar calculadoras (coincidencias limitadas con esquemas de entrada)
• /api/converter/categories — categorías de conversores con unidades
• POST /api/converter/convert — conversor directo, cuerpo { category, from, to, value }

Autenticación (opcional pero recomendada)

Las llamadas anónimas funcionan — la autenticación es opcional. Añadir un token desbloquea analíticas de uso por usuario en /account/mcp-logs: cada llamada que hagas con un token aparece allí con la latencia, el motivo del error y la calculadora utilizada.

Obtén un token (60 segundos)

1. Inicia sesión (o crea una cuenta primero).
2. Ve a /account/api-tokens.
3. Haz clic en Generate token. Copia el valor — solo se muestra una vez.

Añádelo a tu cliente MCP

El mismo archivo de configuración que la instalación pública, más un campo headers.Authorization:

{
  "mcpServers": {
    "calculatorlib": {
      "url": "https://calculatorlib.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN_HERE"
      }
    }
  }
}

¿Por qué molestarse?

• Registros de uso personales — mira qué calculadoras llamas más y cuáles fallan, limitado solo a tu token (/account/mcp-logs).
• Varios clientes, tokens separados — crea uno por dispositivo (portátil, servidor, agente). Revocar uno no interrumpe los demás.
• Base para futuras funciones por usuario — cuando añadamos límites de tasa / cuotas / preajustes guardados, se vincularán a las llamadas autenticadas.

curl con token Bearer

curl -X POST https://calculatorlib.com/mcp \
  -H 'Authorization: Bearer YOUR_TOKEN_HERE' \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Operadores de servidor: establece MCP_REQUIRE_AUTH=true para exigir un token en cada llamada (anónimo → 401). La antigua variable MCP_API_TOKEN aún funciona como atajo de secreto compartido único.

FAQ & resolución de problemas