drawmath

drawmath

技術図面上のメートル法とヤード・ポンド法の値を、現場で実際に使われている換算係数と丸め方法で変換します。ローカルで動作し、ネットワーク接続も設定も不要です。

値を1つ、印刷された引出線注記を1つ、またはねじの呼びを1つ drawmath に渡すと、もう一方の単位系で結果を返します。長さと GD&T の値、±公差、はめあい等級付きの直径、表面粗さ、重量、ねじに対応しています。各結果には、正確な換算値と丸め後の表示値、導出方法（exact、rounded、table、nearest）、信頼度スコアが含まれます。

精度

• 換算係数には国際的な定義を使用します。1インチあたり25.4 mm、1ポンドあたり0.45359237 kgです。
• 表示値は現場の慣例に従います。0.01 mm刻みの値は、小数点以下4桁のインチ値になります。
• 計算例：84±0.1 mm は 3.3071±0.0039 in に、Ø30 H7 は Ø1.1811 H7 に、Ø40 H7 は Ø1.5748 H7 に、Ra 1.6 µm は Ra 63 µin に変換されます。
• ねじは M2～M30 を網羅するメートルねじ／UNC対照表と照合します。完全に一致するものがない場合は、ねじの外径を基準に最も近い規格に対応付けます。M8 は 5/16-18 UNC に、M6 は 1/4-20 UNC に、1/4-20 UNC は M6 に変換されます。一致したねじは、あくまで最も近い規格であり、互換性があるとは限りません。すべてのねじの結果に、その旨が明記されます。

ツール

これは、元の5つのツールを一部に絞ったものです。3つのツールを実装しています。

• convert_value — 1つの値を変換します。value（例："84±0.1 mm"、"Ø30 H7"、"Ra 1.6"、"2.5 kg"、"M8"）を指定し、任意で kind（length、tolerance、gdt、roughness、weight、thread、auto のいずれか）と direction（metric_to_imperial、imperial_to_metric、auto のいずれか）を指定します。結果の JSON には、正確な値と表示値、導出方法、信頼度スコアが含まれます。
• convert_text — 引出線注記全体を変換します。text を指定し、任意で direction を指定します。表記は維持されます。記号、はめあい等級、乗数は元の位置に残り、角度は変換されません。
• lookup_thread — ねじの相互参照を行います。"M8" や "1/4-20 UNC" などの designation を指定すると、対照表の行と、もう一方の単位系で最も近い対応規格を返します。省略すると、M2～M30 の表全体を返します。

元のツールのうち2つは、この一部から除外されています。 extract_drawing_text と convert_drawing_pdf です。これらは、公開された仕様から再現できないPDFのテキスト抽出・スタンプエンジンに依存しており、このビルドにはPDFライブラリが含まれていません。同様に、元の convert-drawing プロンプトも対象外です。プロンプトは、このプログラムのツール互換性の対象範囲に含まれないためです。

引数の形式は、仕様から再構成したものです。公開資料では動作と計算例は示されていますが、パラメーター表は記載されていません。そのため、各ツールでは、動作から想定される主要な文字列に加え、動作に応じて任意の方向または種類を指定します。

CLI

npx @reneturcios/drawmath convert_value '{"value":"84±0.1 mm"}'
npx @reneturcios/drawmath convert_text '{"text":"Ø30 H7"}'
npx @reneturcios/drawmath lookup_thread '{"designation":"M8"}'
npx @reneturcios/drawmath lookup_thread '{}'
npx @reneturcios/drawmath --version

終了コード：成功時は 0、実行時エラー時は 1、使用方法のエラー時は 2 です。

MCP サーバー

npx -y @reneturcios/drawmath mcp

MCP クライアントの設定：

{
  "mcpServers": {
    "drawmath": {
      "command": "npx",
      "args": ["-y", "@reneturcios/drawmath", "mcp"]
    }
  }
}

Docker

docker run -i ghcr.io/cloudcorprecords/drawmath
docker run --rm ghcr.io/cloudcorprecords/drawmath convert_text '{"text":"M8"}'

開発

npm install
npm run build   # tsc -> dist/
npm test        # tsx --test test/*.test.ts (fixture arithmetic only, no network)
npm run dev     # run the CLI from source

ライセンス

MIT — Copyright (c) 2026 Rene Turcios