llama.cpp, 로컬 모델, FreeCAD(및 pi 코딩 에이전트)를 활용해 기계적으로 작동하고 3D 프린팅/밀링이 가능한 객체를 생성하는 9단계 가이드
9 easy steps for llama.cpp, a local model, Freecad (and pi coding agent) to generate solid objects that sound mechanically good and can be also be 3D printed/milled
핵심 요약
로컬 LLM과 FreeCAD를 연동하여 자연어로 3D 모델을 설계하고 출력하는 워크플로우를 소개합니다.
- 워크플로우 구축 — llama.cpp와 FreeCAD MCP를 연동하여 자연어 명령으로 3D 객체 설계함
- 에이전트 활용 — pi 코딩 에이전트나 llama-server를 통해 모델이 직접 CAD 작업을 수행하도록 설정함
- 시각적 검증 — 멀티모달 모델의 비전 기능을 활용해 생성된 기하학적 구조의 정확성을 검증함
- 실제 활용 — 3D 프린팅이나 밀링이 가능한 기어와 같은 복잡한 기계 부품을 설계함
리눅스에서 빠르게 설정하는 법:
STEP 0:
llama.cpp, Freecad, 그리고 본인이 좋아하는 gguf 모델을 설치/다운로드해라. 멀티미디어 이미지 읽기 기능이 있는 모델이면 더 좋다(난 Unsloth가 양자화한 Qwen3.8-27B-UD-Q4_K_M이랑 관련 mmproj-F16을 썼음). uv나 pi.dev도 챙기고.
STEP 1:
$ cd /your/path/to/ (설치할 경로로 이동)
STEP 2:
$ git clone https://github.com/neka-nat/freecad-mcp.git`(https://github.com/neka-nat/freecad-mcp.git)
STEP 3:
$ cp -r freecad-mcp/addon/FreeCADMCP ~/.local/share/FreeCAD/v1-1/Mod/
STEP 4.1:
pi 코딩 에이전트를 모델링 보조 도구로 쓸 거면, ~/.pi/agent/mcp.json 파일에 아래 내용을 적어라:
그리고/또는
STEP 4.2:
llama-server를 모델링 보조 도구로 쓸 거면, freecad_mcp.json이라는 파일에 아래 내용을 적어라:
{
"mcpServers": {
"freecad": {
"command": "uv",
"args": [
"--directory",
"/your/path/to/freecad-mcp",
"run",
"freecad-mcp"
]
}
}
}
STEP 5.1 (pi를 모델링 에이전트로 쓸 때):
$ pi update; pi install npm:pi-mcp-extension
pi를 실행한 다음, pi에다가 이 명령어를 입력해라:
/mcp:start freecad
그리고/또는
STEP 5.2 (llama server를 모델링 에이전트로 쓸 때):
평소처럼 llama-server를 실행하되, --mcp-servers-config /your/path/to/freecad_mcp.json 옵션을 추가해라.
llama-server 웹 UI의 Settings > Tools > Server에서 freecad_* 도구들이 제대로 뜨는지 확인해라. 필요하면 권한 묻지 않고 바로 실행되게 설정해두고, Settings > Agentic > Agentic turns에서 값을 99 정도로 올려놔라.
