<!-- mcp-name: io.github.jeongho54/loadbench -->

# 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
```

## Use it in Claude Desktop

Add to your `claude_desktop_config.json`:

```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