drawmath

Name: drawmath
Author: CloudCorpRecords

本地服务

github.com/CloudCorpRecords科研与教育01 周前更新

代码仓库

关于 drawmath

drawmath 是面向跨公制与英制工作的技术图纸用户的本地换算服务。它处理尺寸、公差、表面粗糙度、重量和螺纹，并给出精确值、显示取整值、推导方式及置信度。

主要功能

01换算尺寸与公差
02换算 GD&T 和粗糙度标注
03在两种单位制间换算重量
04交叉查询公制与 UNC 螺纹
05提供精确值、显示值和置信度

适用场景

01在两种单位制间转换图纸标注
02核对另一单位制下的公差
03通过图表对照螺纹规格
04检查换算的精确值与取整值

MCP 相关

向 MCP 客户端提供 `convert_value`、`convert_text` 和 `lookup_thread` 工具。不包含 PDF 文本提取和图纸转换。

配置

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

mcp.json · 通用配置

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

启动命令npx -y @reneturcios/drawmath

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

安装包

npm@reneturcios/drawmath0.1.0stdio

ocighcr.io/cloudcorprecords/drawmath:0.1.0stdio

工具

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

参数	类型	必填	说明
kind	enum	否	本次调用的类别。length \| tolerance \| gdt \| roughness \| weight \| thread \| auto
value	string	是	本次调用的值。
direction	enum	否	此调用的方向。metric_to_imperial \| imperial_to_metric \| auto

详细介绍

drawmath

技术图纸上的公制和英制数值，按照车间实际使用的换算系数和取整规则进行转换——在本地完成，无需网络调用，也无需任何配置。

向 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。匹配到的螺纹是最接近的标准规格，并非可互换规格——每个螺纹结果都会明确说明这一点。

工具

这是原有五工具范围的一个带标签子集。已实现三个工具：

convert_value — 转换单个数值：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 — 查询螺纹对应关系：提供 designation，例如 "M8" 或 "1/4-20 UNC"，即可获取其对照表条目及另一种单位制下最接近的对应项；也可以省略，以获取完整的 M2–M30 对照表。

原有工具中有两个未纳入此子集： 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