loadbench

Name: loadbench
Author: jeongho54

本地服务

github.com/jeongho54科研与教育017 周前更新

代码仓库

关于 loadbench

loadbench 是为 AI 助手提供结构载荷与稳定性计算的 MCP 服务，涵盖倾覆、支撑反力以及梁的应力和挠度检查。计算结果以手算答案验证，适用于规划估算，不是认证工程结论。

主要功能

01检查载荷是否导致倾覆
02计算支腿或托架的载荷
03检查梁的应力与挠度
04以手算结果验证计算

适用场景

01评估物体是否会因载荷倾覆
02估算支腿或托架的受力
03初步检查货架或梁能否承载

MCP 相关

该服务向 MCP 客户端提供 check_tipping、solve_supports 和 beam_check 工具，用于结构载荷与稳定性计算。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

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

启动命令uvx loadbench-mcp

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

pypiloadbench-mcp0.1.0stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
masses	array	是
base_polygon	array	是

详细介绍

loadbench-mcp

一个用于计算结构载荷与稳定性的 MCP 服务，解决大模型容易算错的问题。AI 助手会调用它，而不是凭空猜测。

工具	回答的问题
`check_tipping`	这些重量会不会从占地范围内倾倒？
`solve_supports`	每条支腿／托架承受多少载荷？
`beam_check`	这根梁或搁板能否承受载荷？（应力 + 挠度）

所有计算均已通过手工计算结果验证（tests/test_physics.py）。

安装与运行

发布到 PyPI 后，任何 MCP 客户端都可以直接启动，无需安装：

uvx loadbench-mcp

也可以安装：

pip install loadbench-mcp
loadbench-mcp

在 Claude Desktop 中使用

将以下内容添加到 claude_desktop_config.json：

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

重启 Claude Desktop，然后可以询问类似这样的问题：“一块长 2 m 的松木搁板，由两个距两端各 0.3 m 的托架支撑——能否承受中间 40 kg 的重量？”

本地开发

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

输入单位为 SI 单位（米、千克、牛顿；1 kg ≈ 9.81 N）。工具的文档字符串包含完整的参数详情，模型会自动读取。