LC

lburny/cadpilot

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

26 stars 0 forks Качество 80 Тренд 26MIT

CADPilot - это MCP-сервер, который позволяет клиентам AI (ClaudeCode, OpenCode, DSH, ZCode) пилотировать FreeCAD, создавать ограниченные эскизы, параметрические функции и постоянные совместные сборки из естественных источников.

Обзор

CADPilot - это сервер MCP (Model Context Protocol), который предоставляет клиентам AI (Cherry Studio, Claude Code, ZCode, Kimi Code, Claude Desktop, ...) полный контроль над FreeCAD: создавать документы, создавать ограниченные эскизы, запускать параметрические функции, собирать детали с постоянными соединениями и проверять геометрию, все через вызовы инструментов по XML-RPC. Модели, построенные ИИ через CADPilot (демофайлы живут в примерах/): * : переменные, управляемые электронными таблицами, полностью ограниченные эскизы, функции PartDesign (pad/pocket/revolution/...), операции по переодеванию и многозрительный 2D→3D визуальный корпус, все через один унифицированный кад() инструмент. *: каждая мутация также публикуется на стороне FreeCAD и отображается в доке: запустите запланированные шаги, примите хорошие (мягкий замок), отклоните или откатите остальные, отредактируйте параметры на месте и переиграйте всю сборку из журнала.

Обзор (машинный перевод)

** Английский ** Китайский

AI pilots FreeCAD. CADPilot - это сервер MCP (Model Context Protocol), который предоставляет клиентам AI (Cherry Studio, Claude Code, ZCode, Kimi Code, Claude Desktop, …) полный контроль над FreeCAD: создавать документы, создавать ограниченные эскизы, запускать параметрические функции, собирать детали с постоянными соединениями и проверять геометрию, все через вызовы инструментов по XML-RPC.

##Витрина

Модели, построенные ИИ через CADPilot (демофайлы живут в examples/):

Рюкзак, настольный фэн [править править код] [править] Скрипка Лист* [править]

Особенности

Параметрическое моделирование, от конца до конца: переменные, управляемые электронными таблицами, полностью ограниченные эскизы, функции PartDesign (pad/pocket/revolution/…), операции по переодеванию и многозрительный 2D→3D визуальный корпус, все через один унифицированный инструмент cad(). ***Шаг журнал и обзор цикл **: каждая мутация также журналируется на стороне FreeCAD и показана на панели **Шаги ** док: запустить запланированные шаги, принять хорошие (мягкий замок), отклонить или откатить остальные, отредактировать параметры на месте, и воспроизвести всю сборку из журнала.

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

CADPilot

English | Chinese

AI pilots FreeCAD. CADPilot is an MCP (Model Context Protocol) server that gives AI clients (Cherry Studio, Claude Code, ZCode, Kimi Code, Claude Desktop, …) full control of FreeCAD: create documents, build constrained sketches, run parametric features, assemble parts with persistent joints, and verify geometry, all via tool calls over XML-RPC.

Showcase

Models built by the AI through CADPilot (demo files live in examples/):

Backpack Desk Fan
Violin Leaf

Features

  • Parametric modeling, end to end: spreadsheet-driven variables, fully constrained sketches, PartDesign features (pad/pocket/revolution/…), dress-up ops, and a multi-view 2D→3D visual hull, all through one unified cad() tool.
  • Step journal & review loop: every mutation is also journaled on the FreeCAD side and shown in the Steps panel dock: run planned steps, accept the good ones (soft lock), reject or roll back the rest, edit parameters in place, and replay the whole build from the journal. execute_code is a first-class citizen: a snippet that changes the model is wrapped in a transaction and becomes a rollback-able, replayable step, while a read-only inspection never blocks a rollback. Hand edits in the GUI sync back into the recorded steps; session rollback remains for whole-session undo.
  • Persistence: sessions, patterns, and settings survive restarts as JSON under ~/.cadpilot/; pause a session today, resume it tomorrow.
  • Geometry sensing: measure volumes/areas, inspect face/edge topology, and check interference after every step; quantitative feedback replaces guesswork on complex models.
  • Data-driven assembly: named anchors, residual-checked mates, connectivity audits, and persistent joints (FreeCAD 1.1 Assembly workbench) with declarative priority trimming.
  • Workflow memory: successful modeling recipes are stored as reusable patterns and recalled on demand; the agent gets better the more you use it.
  • Built-in troubleshooting: the diagnose tool probes the RPC port, the FreeCAD process, the addon install and its logs on Windows/macOS/Linux, ends with a concrete fix, and works even while FreeCAD is down or frozen. get_addon_log reads the addon’s debug ring buffer even when the GUI is wedged.
  • Token-friendly: text-first responses with screenshots on demand via get_view (384 px cap, file delivery), a tiny tool surface, and on-demand operation docs keep context usage low.
Открыть полный README на GitHub

Установка

uvx cadpilot
Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{ "mcpServers": { "cadpilot": { "command": "uv", "args": ["--directory", "/path/to/cadpilot", "run", "--no-sync", "cadpilot"] } } }