Skip to main content
Glama
loadbench-mcp

loadbench-mcp

by jeongho54

loadbench-mcp

An MCP server that does the structural load & stability math language models get wrong. AI assistants call it instead of guessing.

Tool

Question it answers

check_tipping

Will these weights topple over their footprint?

solve_supports

How much load does each leg / bracket carry?

beam_check

Will this beam or shelf hold the load? (stress + deflection)

All math is verified against hand-computed answers (tests/test_physics.py).

Install & run

Once published to PyPI, any MCP client can launch it with no install step:

uvx loadbench-mcp

Or install it:

pip install loadbench-mcp
loadbench-mcp

Related MCP server: MCP Mathematics

Use it in Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "loadbench": {
      "command": "uvx",
      "args": ["loadbench-mcp"]
    }
  }
}

Restart Claude Desktop, then ask things like "A 2 m pine shelf on two brackets 0.3 m from each end — will it hold 40 kg in the middle?"

Local development

uv run --with mcp --with numpy python -m load_solver.server   # run from source
python -m pytest tests                                         # verify the math

Inputs are SI units (metres, kilograms, newtons; 1 kg ≈ 9.81 N). Tool docstrings carry the full argument details, which the model reads automatically.

Estimates for planning, not certified engineering. For loads where a failure could cause injury or real damage, have a qualified engineer check the result.

License

MIT

Available Tools

3 tools
beam_checkA

Check whether a beam or shelf holds a load: bending stress and deflection.

Closed-form Euler–Bernoulli check. "point" puts the whole load at the centre (simply supported) or the free end (cantilever); "udl" spreads magnitude_n evenly along the span. Give the section either directly (section_modulus_m3 and inertia_m4) OR as a solid rectangle (width_m and height_m).

Args: span_m: clear span / length, metres. support_type: "simply_supported" (held both ends) or "cantilever" (one end). load_type: "point" or "udl" (uniformly distributed). magnitude_n: total load in newtons (1 kg ≈ 9.81 N). e_pa: Young's modulus of the material, pascals (steel ≈ 2.0e11, pine ≈ 9e9). allowable_stress_pa: allowable bending stress of the material, pascals. section_modulus_m3: Z, if known. Else give width_m and height_m. inertia_m4: I, if known. Else give width_m and height_m. width_m, height_m: for a solid rectangle, used to compute Z and I. deflection_limit_ratio: optional, e.g. 250 means limit deflection to span/250.

Returns: max_moment_nm, max_stress_pa, max_deflection_m, stress utilisation, pass/fail, governing check, and a short explanation.

Inputs: e_pa (required), span_m (required), load_type (required), magnitude_n (required), +7 more.

check_tippingA

Check whether a collection of weights will tip over its support footprint.

Computes the centre of mass and tests whether its vertical projection falls inside the support base (the polygon where the object touches the ground). If it falls outside, the object tips. Use this for shelving, stacked loads, machinery on legs, vehicles, or anything that could topple.

Args: masses: list of point masses, each {"x": metres, "y": metres, "mass": kg}. x/y are top-down (plan-view) positions. Height does not affect whether it tips on level ground, only the horizontal centre of mass does. base_polygon: the support footprint as ordered vertices [{"x", "y"}, ...] in metres (e.g. the four feet of a shelf, or the contact outline).

Returns: center_of_mass, is_stable (bool), tipping_margin_m (positive = inside the base with this much clearance; negative = already outside / tipping), tipping_direction (unit vector toward the closest base edge), and a short human-readable explanation.

Inputs: masses (required), base_polygon (required).

solve_supportsA

Compute how much vertical force each support (leg, bracket, foot) carries.

Models a rigid object resting on point supports of equal stiffness and solves static equilibrium so the reactions balance every applied load in force and moment. Handles any number of supports. Flags supports that exceed their rated capacity, and supports with a negative reaction (the object is lifting off / would tip rather than rest evenly).

Args: supports: [{"id": str, "x": m, "y": m, "capacity_n": N (optional)}]. loads: downward point loads [{"x": m, "y": m, "magnitude_n": N}]. self_weight_n: optional self-weight of the object (N), applied at the centroid of the supports.

Returns: per-support reaction forces, over-capacity / lift-off flags, total load, max utilisation, any warnings, and a short explanation.

Inputs: loads (required), supports (required), self_weight_n.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.4/5.0

    Scored across 3 tools

    Disambiguation5/5

    Each tool targets a distinct structural analysis task: beam bending, tipping stability, and support reactions. There is no overlap in functionality, and the descriptions clearly differentiate them.

    Naming Consistency4/5

    Two tools follow a verb_noun pattern (check_tipping, solve_supports) while one is noun_verb (beam_check). The naming is clear and readable, but the slight inconsistency prevents a perfect score.

    Tool Count5/5

    Three tools provide a focused set for basic structural analysis, covering beam checks, tipping, and support reactions. The count is appropriate for the domain without being too sparse or overwhelming.

    Completeness4/5

    The tools cover core structural analysis needs for simple loads and supports. Missing features like shear checks or multiple load combinations are minor gaps, but the set is functional for its stated purpose.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      MCP server that exposes CAD geometry reasoning over STEP files to LLMs, allowing natural language queries about parts, assemblies, dimensions, holes, and mass properties.
      -
    • A
      license
      C
      quality
      D
      maintenance
      A comprehensive MCP server that turns any AI assistant into a powerful mathematical computation engine, providing 52 advanced functions, 158 unit conversions, financial calculations, and secure AST-based evaluation.
      18
      16
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      An MCP server that gives an AI assistant a set of real mechanical-engineering tools. Provides deterministic tools like material properties, beam analysis, unit conversion, and curve fitting for engineering calculations.
      5
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      An MCP server for construction tools that calculates wall formwork material takeoffs from geometry inputs, enabling LLMs to generate accurate bills of materials.
      -