TechDraw AI

本地服务

techdrawai.com媒体与设计32 周前更新

代码仓库访问官网

关于 TechDraw AI

TechDraw AI Skills 提供 Agent 技能和 MCP 服务，可将照片或文字描述转为技术图纸、CAD 文件、3D 网格和产品渲染图。它面向使用个人 TechDraw AI API 密钥制作工程文档的用户。

主要功能

01根据照片或文字生成技术图纸
02生成 DXF 和可选的 DWG
03生成可打印 STL 与 3D 网格
04根据图纸渲染产品图
05结果写入磁盘并返回路径

适用场景

01根据零件照片制作尺寸图
02将图像转换为 CAD 轮廓
03根据照片或图纸生成 3D 模型
04将技术图纸渲染为产品图

MCP 相关

MCP 服务向 MCP 客户端提供图纸、CAD、3D 建模、渲染、产品识别和额度查询工具。每位用户使用自己的 TechDraw AI API 密钥进行身份验证。

配置

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

mcp.json · 通用配置

{
  "mcpServers": {
    "meltflexdevs-techdrawai": {
      "command": "npx",
      "args": [
        "-y",
        "techdrawai-mcp"
      ],
      "env": {
        "TECHDRAWAI_API_KEY": "<TECHDRAWAI_API_KEY>"
      }
    }
  }
}

启动命令npx -y techdrawai-mcp

需要配置的环境变量

TECHDRAWAI_API_KEY密钥Your TechDraw AI API key (tda_sk_...). Requires an active Studio plan. Create one at https://techdrawai.com/app?view=settings, or run `npx -y techdrawai-mcp auth login` to sign in through the browser instead.

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

安装包

npmtechdrawai-mcp0.4.0stdio

工具

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

参数	类型	必填	说明
image	string	是	产品照片：本地文件路径、http(s) URL 或 data:image/…;base64,… URL。
notes	string	否	图纸上的其他说明（材料、表面处理、公差）。
units	enum	否	主要图纸单位。默认为 mm。mm \| cm \| m \| in
views	array	否	要包含的视图。默认为正视图、俯视图和侧视图。
standard	enum	否	制图标准。ISO（默认）或 ANSI。ISO \| ANSI
paper_size	string	否	图纸尺寸：ISO 使用 A4/A3/A2/A1/A0（默认 A3），ANSI 使用 "ANSI A"…"ANSI E"（默认 "ANSI B"）。
projection	enum	否	投影角。第一角法（默认，ISO/欧洲）或第三角法（ANSI/北美）。first-angle \| third-angle
output_path	string	否	图纸的保存位置。默认为 ./techdrawai-output/drawing-<timestamp>.png。
drawing_type	enum	否	working = 完整标注尺寸的生产图纸（默认）；assembly = 编号气泡标注 + 零件清单；as-fitted = 按实际制造状态记录物品；patent = 编号图示，不含尺寸。working \| assembly \| as-fitted \| patent
measurements	array	否	在物体上实际测得的尺寸。其他所有特征都将据此按比例缩放，因此只需一项准确测量，就能使整张图纸准确。
product_name	string	否	物体是什么，例如 "oak dining chair"。有助于完善标题栏并估算尺寸。如果不确定，请先使用 `identify_product`。
estimate_dimensions	boolean	否	让模型推断符合实际的尺寸。未提供测量值时默认为 true，提供测量值时默认为 false。

详细介绍

TechDraw AI 技能

借助 TechDraw AI，AI Agent 技能可将实体零件的照片转化为工程文档。绘制带尺寸的 2D 技术图纸，将其描绘为可用于 CAD 的 DXF 和 DWG，重建零件的 3D 网格，或将其渲染为成品产品图。适用于 Claude Code、Claude Desktop、Cursor、Codex、VS Code、Windsurf，以及任何能够加载 Markdown 技能或支持 MCP 的工具。

每位用户都使用自己的 TechDraw AI API 密钥进行身份验证，所有生成费用均从其账户额度中扣除。这些技能直接调用公开的 TechDraw AI API，因此无需额外安装，也无需构建 CAD 内核。

工业黄铜球阀的照片同一阀门的尺寸标注技术图纸同一阀门的着色 3D CAD 模型

_{一张照片，三种输出：带尺寸的图纸、CAD 几何图形和 3D 模型。}

安装

任选一种方式。每种方式都会为你的 Agent 设置好技能。

`npx skills`（推荐，跨 Agent）

npx skills add MeltFlexDevs/techdrawai-skills

GitHub CLI（v2.90+）

gh skill install MeltFlexDevs/techdrawai-skills

Claude Code marketplace

在 Claude Code 中：

/plugin marketplace add MeltFlexDevs/techdrawai-skills
/plugin install techdrawai@techdrawai

仅安装 MCP 服务

如果你只需要工具而不需要技能，可直接添加 MCP 服务：

claude mcp add techdrawai -- npx -y techdrawai-mcp

Cursor、Claude Desktop、Codex、VS Code 和 Windsurf 的配置说明见 MCP 页面。

设置脚本

通用备用方案：

git clone --depth 1 https://github.com/MeltFlexDevs/techdrawai-skills.git
cd techdrawai-skills
./setup

更多选项见 INSTALL.md。由 Agent 驱动的安装说明，可粘贴到你的 Agent 中：INSTALL_FOR_AGENTS.md。

身份验证

程序化访问属于 Studio 计划。订阅后，最简单的登录方式是通过浏览器流程：它会根据你的会话生成密钥，并通过回环接口传回，因此你无需复制或粘贴密钥：

npx -y techdrawai-mcp auth login

或者在 techdrawai.com/app → Settings → API keys 手动创建密钥并将其导出：

export TECHDRAWAI_API_KEY="tda_sk_..."

密钥在创建时仅显示一次。系统只存储其 SHA-256 值，因此之后任何人都无法找回密钥，包括我们。一个账户最多可拥有五个有效密钥，撤销密钥后会在下一次请求时生效。

技能

技能	调用方式	涵盖内容
`techdrawai-drafting`	`/techdrawai:drafting`	将照片或文字描述转换为带尺寸的技术图纸。绘图标准、图纸尺寸、投影角度、图纸类型、视图，以及用于确定比例的基准尺寸。
`techdrawai-cad`	`/techdrawai:cad`	图纸的所有后续处理：按真实尺寸生成 DXF 和 DWG、可打印的 STL、根据照片或图纸进行 3D 重建，以及产品渲染图。

工具

工具	功能	费用
`generate_technical_drawing`	将照片转换为带尺寸、符合标准的技术图纸	5 个点数
`text_to_technical_drawing`	将带尺寸的文字描述转换为技术图纸，无需照片	5 个点数
`image_to_dxf`	将任意图像转换为真正的 CAD 轮廓，输出为 DXF，也可选 DWG	免费
`image_to_stl`	将平面图稿（徽标、模板、线稿）挤出为可打印的 STL	免费
`render_product`	将技术图纸转换为照片级逼真的产品渲染图	5 个点数
`photo_to_3d`	将照片转换为带纹理的 3D 网格，输出 GLB 以及 FBX、OBJ、USDZ、STL	80 个点数
`drawing_to_3d`	将技术图纸转换为带纹理的 3D 网格，一次调用，一次计费	80 个点数
`identify_product`	说出照片中物体的名称	免费
`check_credits`	查看余额、套餐以及每项操作的费用	免费

生成失败会自动退款，因此 Agent 重试错误的提示词时，不会悄悄耗尽余额。

每个工具都会将结果写入磁盘（除非传入 output_path，否则写入 ./techdrawai-output/），并返回路径而不是字节数据。技术图纸的图像可能有数 MB 大，若通过协议传输，Agent 的上下文就会被这些内容占用，而通常它只需将结果交给下一个工具即可。

实际使用效果

你：这是一个支架，~/photos/bracket.jpg。它宽 120 mm。我需要一份用于激光切割机的 DXF。

[identify_product]  → "steel wall bracket"

[generate_technical_drawing]
  product_name: "steel wall bracket"
  measurements: [{ value: "120", unit: "mm", position: "overall width" }]
  standard: ISO · paper_size: A3 · drawing_type: working
→ ./techdrawai-output/drawing-2026-07-27_15-04-11.png   5 credits

[image_to_dxf]  width_mm: 120
→ ./techdrawai-output/drawing-2026-07-27_15-04-11.dxf   34 contours, free

DXF 按真实尺寸生成，因此无需缩放即可直接用于切割机。更多示例请参阅 COOKBOOK.md。

一项测量，改变一切

没有真实测量值时，尺寸只能由模型尽力估算，并会标记为名义尺寸。即使只提供一个测量值，其余所有特征也会按比例缩放，整张图纸由此变得内部一致且可制造。如果用户没有提供测量值，请向其询问。这是整个工作流中影响质量最大的因素。

CLI

如果运行时提供参数，而不是让 Agent 通过 MCP 与其交互，同一个软件包也可作为命令行工具使用：

techdrawai draw -i bracket.jpg --measure 120:"overall width" --paper A3
techdrawai dxf  -i drawing.png --width-mm 120 --dwg
techdrawai model3d -i bracket.jpg --detail high

完整参考文档见 techdrawai.com/cli。

文档

API 参考：所有端点、请求和响应
CLI：所有命令和标志
MCP：针对每种客户端的配置说明
COOKBOOK.md：示例详解
CONTRIBUTING.md

许可证

MIT。请参阅 LICENSE。

支持 Markdown

登录后评论

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。

TechDraw AI

关于 TechDraw AI

主要功能

适用场景

MCP 相关

配置

工具

详细介绍

TechDraw AI 技能

安装

npx skills（推荐，跨 Agent）

GitHub CLI（v2.90+）

Claude Code marketplace

仅安装 MCP 服务

设置脚本

身份验证

技能

工具

实际使用效果

一项测量，改变一切

CLI

文档

许可证

评论

第一次接触 MCP？

MCP（Model Context Protocol）是什么？

MCP 服务和客户端有什么区别？

本地服务与远程服务怎么选？

如何在 Claude、Cursor 等客户端中安装服务？

收录的项目经过审核吗？“认证”标识代表什么？

我维护的项目已被收录，怎样认领？

`npx skills`（推荐，跨 Agent）