Jobsite Math

面向 AI 助手的只读美国建筑计算器:屋顶坡度、四坡屋顶、混凝土、碎石、砖块、砂浆、油漆、石膏板、露台板、加价率和时薪。通过 stdio 在本地运行,不进行网络调用。

文档

jobsite-math

Exact, tested calculators for the math US contractors do every day, in two packages:

PackageWhat it is
jobsite-mathZero-dependency TypeScript functions: roof pitch, hip roof, concrete, gravel, brick, mortar, paint, drywall, deck boards, markup, hourly rate.
jobsite-math-mcpA read-only MCP server exposing the same functions to Claude, Cursor and other AI assistants.
npm install jobsite-math
npx -y jobsite-math-mcp   # MCP server over stdio

US units throughout, with the unit in every field name. Product figures such as bag yield, paint coverage and gravel density are inputs, never hidden constants. Quantities round up to whole bags, sheets and boards. See packages/core for every formula and its limits.

Develop

npm install
npm test        # builds both packages, runs unit tests and an end-to-end stdio test

Node.js 22.18 or later for development (tests run TypeScript directly). The published packages need Node.js 20 or later.

Issues and pull requests are welcome, especially corrections from people who do this work on site.

License

MIT. Copyright (c) 2026 JW Digital Services Ltd. The same math runs the free browser calculators at contractorwebsiteshq.com/us/tools.