PartCAD

io.github.partcad由 GitHub 账号 partcad 发布v0.9.2更新于 Nov 5, 2026

Inspect, render, test and export the parts and assemblies of PartCAD hardware packages

概览

AI 生成的概览

让助手查看、渲染、测试、搜索并导出 PartCAD 硬件代码包中的零件与装配体。

可以做什么
  • 列出并查看包、零件、草图、装配体、场景、接口与材料,以及它们的参数和属性
  • 将对象渲染为图片,或导出为工作区中的 STEP、STL、3MF 等文件
  • 按对象声明的需求与测试进行检查,并检查包的配置与脚本是否有误
  • 按关键词或接口搜索零件与包,并生成物料清单或分步装配说明
  • 先列出可用的守护进程方法,再通过通用执行工具运行其他 PartCAD 方法
适用场景
适用于以 PartCAD 包形式在 Git 中管理可制造产品的项目,希望助手查看模型、按声明的需求验证,或产出导出文件、物料清单和装配说明。面向 CAD 与硬件工程工作,而非一般文件处理。
运行要求
以 Python 包 partcad 通过 stdio 在本机运行,例如使用 uvx。服务的工作区由环境变量 PC_PATH 指定,未设置时使用当前工作目录。对象首次渲染需要构建,可能耗时数分钟。仅限桌面环境;未声明身份验证。
安装前请注意
导出工具会向工作区写入文件,执行工具可运行任意守护进程方法,包括添加、导入、转换、安装以及可触发自动采购的方法。装配说明会套用本机上的自建或外购选择。未设置 PC_PATH 时会服务当前工作目录,请确认指向预期的包。

安装

在 SourceWeft 中

  1. 打开 控制台中的 PartCAD,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

PartCAD

[CI on Linux, macOS and Windows] [PyPI] [Documentation Status] [Discord] [License]

PartCAD is the programming language for manufacturable things.

A package is a Git repository with a partcad.yaml that declares parts (CAD scripts or files), assemblies, materials and requirements. PartCAD renders, tests, simulates, analyses and documents them, and produces the bill of materials, the sourcing and the assembly instructions from that same source. Everything is text, so it is versioned, reviewed and generated like software, by people and by AI agents.

Documentation · Website · Demos · Discord

[PartCAD in Visual Studio Code]

Install

Pick one. Every option ends up with the same pc command line tool and the same packages.

You haveInstall
Nothing yetThe PartCAD IDE: curl -fsSL https://raw.githubusercontent.com/partcad/partcad/main/install.sh | sh -s -- --ide, or the Windows and macOS installers on the releases page
Pythonpip install -U partcad
Visual Studio Codecode --install-extension PartCAD.partcad-official (marketplace)
Claude Code/plugin marketplace add partcad/partcad@plugin-dist, then /plugin install pc@partcad, then /pc:setup

The standalone command line tools without Python, the snap, the FreeCAD add-on, the MCP server for other AI agents, and the per-OS notes are all in Installation.

Try it

shell
pc init                      # a package in the current directory, with agent skills for Claude Code and Cursorpc ide view my_part          # show it in the Digital Thread of the IDE or the extensionpc render my_part            # SVG, PNG, DXF... from any anglepc test                      # the ports, interfaces, physics and simulations the objects declarepc instructions my_assembly  # the assembly instruction book, PDF or HTML, with the bill of materials

Or, in Claude Code, /pc:gen a mounting bracket with four M4 holes: the agent writes the CAD script, renders it and checks the result against what was asked.

The tutorial walks through a first package, and examples/ has one directory per feature.

What it does

  • Parts from CadQuery, build123d, OpenSCAD, Chili3D, SDF, STEP, BREP, IGES, STL, 3MF, OBJ, glTF, FreeCAD, Autodesk Fusion, SolidWorks, Autodesk Inventor, CATIA V5, ACIS and Creo View files, KiCad EDA PCBs, and any format a plugin package adds (SolidCraft, Rhino).
  • Assemblies and scenes in Assembly YAML, URDF, or a STEP, Autodesk Fusion or Creo View file, with interfaces and mating as objects.
  • Outputs: STEP, BREP, STL, 3MF, OBJ, IGES, glTF, URDF, Gazebo and MuJoCo worlds, 2D projections, dimensioned drawings, Markdown documentation and PDF or HTML instruction books.
  • Engineering: FEA, modal, thermal and CFD analysis (pc cae), simulation in MuJoCo or Gazebo (pc sim), 2.5D toolpaths (pc cam), and materials and manufacturing methods carried into the bill of materials.
  • Supply chain: a Build vs Buy decision per line item, stock-based procurement for made parts, and automated purchasing from the command line.
  • AI agents: Agent Skills for Claude Code and Cursor, an MCP server (pc mcp), and plain-text --no-ansi output on every command.
  • Caching in memory, on disk, in memcached and in S3, so a team or a CI fleet renders each model once.

The full list of what is supported, and what is still in progress, is in Supported formats and features.

Why

PartCAD is not a drawing tool. It is the layer under the drawing tools: the specification of a manufacturable product, kept in a form that a human, a CI job and an AI model can all read, change and verify. Keeping that specification on-prem, in Git, and portable between CAD tools and manufacturers is the point. See Introduction and Use cases.

Community

Questions and feedback go to Discord; bugs and ideas to GitHub issues. Follow LinkedIn, YouTube and Twitter/X for releases. To contribute, start with Contributing.

Licensed under Apache 2.0.

来源:README.md,提交 57d691d

工具

12

list_objects

List objects

List the packages, parts, sketches, assemblies, scenes, interfaces, materials or software of a package. `pc list <kind>`. The listing is in the log of the result.

输入参数kindpackagerecursive

info

Show an object's declaration

Show an object's configuration, parameters and properties, or the package's when no object is named. `pc info`.

输入参数kindobjectparamspackage

render

Look at an object

Render one part, assembly, scene or sketch and return the picture. `pc render`, returned instead of written. The first render of an object builds it, which can take minutes. Ports, interfaces and callouts are drawn only when asked for.

输入参数kindformatobject必填paramspackagewith_portswith_internalswith_materialsoptions_packagewith_interfaceswith_port_nameswith_component_names另有 2 个

export

Write an object to a file

Export or render one object to a file in the workspace. `pc export` / `pc render` for one object, written where the agent says. The ports, interfaces and callouts are drawn on a picture (png, svg, ...) and mean nothing to a model format such as step.

输入参数kindpath必填format必填object必填paramspackagewith_portswith_internalswith_materialsoptions_packagewith_interfaceswith_port_names另有 3 个

test

Test objects

Check objects against the requirements and tests they declare. `pc test`. ok is false when any check failed, and the errors say which.

输入参数kindobjectparamspackagerecursive

lint

Lint a package

Check a package's partcad.yaml, ASSY files and scripts for mistakes. `pc lint`.

输入参数packagerecursive

bom

Bill of materials

What has to be bought or made to build a part, an assembly or a scene. `pc bom --json`.

输入参数object必填paramspackage

instructions

Assembly instructions

The step-by-step build of an assembly: what goes where, in which order, with which parts. `pc instructions`, as data. The user's Build vs Buy choices on this machine are applied.

输入参数object必填paramspackagesubassemblies

version

PartCAD version

The version of this server and of the daemon serving the workspace, which should be the same.

无需输入参数。

list_methods

List daemon methods

The methods the PartCAD daemon serves, each with a one-line summary, for use with execute.

输入参数filter

execute

Run a daemon method

Run any PartCAD daemon method -- everything the command line can do, and what the IDE asks for. The result carries the method's answer and its log.

输入参数method必填params

版本历史

4
  1. v0.9.2最新Nov 5, 2026
  2. v0.8.273Nov 1, 2026
  3. v0.8.235Oct 24, 2026
  4. v0.8.232Oct 20, 2026

评分

已满足适用检查项的 90%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分
  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分