Metadata-Version: 2.4
Name: loadbench-mcp
Version: 0.1.0
Summary: MCP server for structural load & stability math: tipping, support reactions, beam checks.
Project-URL: Homepage, https://github.com/jeongho54/loadbench-mcp
Project-URL: Repository, https://github.com/jeongho54/loadbench-mcp
Author: jeongho54
License-Expression: MIT
Keywords: beam,engineering,mcp,model-context-protocol,statics,structural,tipping
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Scientific/Engineering
Requires-Python: >=3.10
Requires-Dist: mcp<2,>=1.27
Requires-Dist: numpy>=1.26
Description-Content-Type: text/markdown

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