cadxray MCP server
Commit Oct 20, 2026Enables AI clients to diagnose, modify, and automate FreeCAD models, including sketch repair, parametric rebuilding, and FEM analysis.
Also known as WaveSimm/cadxray
- Stars
- 3
- Tools
- โ
- Downloads, 30 days
- โ
- Latest version
- โ
- Last commit
- Oct 20, 2026
- License
- MIT
What is cadxray MCP?
cadxray enables AI clients to diagnose, modify, and automate FreeCAD models, including sketch repair, parametric rebuilding, and FEM analysis.
Summary generated from the project's README
About cadxray MCP server
Diagnosing, modifying, and automating FreeCAD models directly from AI coding tools is what cadxray enables. It allows developers to use MCP-compatible clients like Claude Code, Cursor, or VS Code to inspect complex geometry, repair broken sketches, and perform parametric rebuilding. The system works by connecting an AI client to a FreeCAD addon via a bridge that communicates over local port 9877, ensuring all data remains on your machine.
Users can automate highly technical CAD workflows such as finite element method (FEM) analysis, 3D printability checks, and 2D technical drawing generation. The server provides specialized tools like get_sketch_diagnostics to identify constraint conflicts and execute_code to apply Python-based fixes. It also supports advanced tasks like converting STL meshes into parametric models or analyzing STEP files for mounting hole patterns and interference. This setup is designed for engineers and developers who want to integrate generative AI into their mechanical design and simulation pipelines.
Written from the project's README. Every use case is checked against a quote from it.
Automated checks
Ran Nov 15, 2026Full report โNot verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work ยท What to fix for more points
- Source repository linked and reachablewavesimm/cadxray is public and reachablegithub.com/wavesimm/cadxray โPass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html โPass
- Commit or release in the last yearLast commit or release 2026-10-20github.com/wavesimm/cadxray โPass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubcadxray
English: README.en.md
AI ๊ฐ FreeCAD ์์ ์ง์ ๋ค์ฌ๋ค๋ด ๋๋ค. ๋๋ฉด์ด๋ ๋ฒค๋ STEP ์ด๋ STL ์ด๋ , ๋ฐฉ๊ธ ๋นจ๊ฐ์ง ์ค์ผ์น๋ ๊ทธ๋๋ก ๋์ง์ธ์.

์ ํ๋ฉด์ ์ ๋ถ FreeCAD 1.1.3 ์์ ์ค์ ๋ก ๋๋ฆฐ ๊ฒ์ด๊ณ , ์ซ์๋ ํด์ด ๋ณด๊ณ ํ ๊ฐ ๊ทธ๋๋ก์ ๋๋ค. ์ง์ ํด ๋ณด๋ ค๋ฉด ๋ฐ๋ผํ๊ธฐ ์ค์ต 11๊ฐ.
FreeCAD ๋ชจ๋ธ์ AI ์ฝ๋ฉ ํด(Claude CodeยทCursorยทVS CodeยทCodexยทGemini CLI ๋ฑ MCP ํด๋ผ์ด์ธํธ)์ด ์ง๋จยท์์ ํ๊ฒ ํด ์ฃผ๋ MCP ์๋ฒ์
๋๋ค. "Sketch003์ด ์ ๋นจ๊ฐ์ง", "Pad๊ฐ ์ ์คํจํ๋์ง"๋ฅผ ๋ฌผ์ผ๋ฉด Claude๊ฐ ํด๋ก ์ง์ ๋ค์ฌ๋ค๋ณด๊ณ ์์ธ์ ๋งํด ์ค๋๋ค. ์์ ์ execute_code๋ก ํ๊ณ , ๊ฒฐ๊ณผ๋ tracked_recompute์ ์คํฌ๋ฆฐ์ท์ผ๋ก ํ์ธํฉ๋๋ค.
- ์ง์: FreeCAD 1.0.x / 1.1.x (1.1.3์์ ๊ฒ์ฆ), Windows ยท macOS ยท Linux
- ๊ตฌ์ฑ: FreeCAD ์์์ ๋๋ ์ ๋์จ(
freecad/cadxray) + AI ํด์ด ๋์ฐ๋ ๋ธ๋ฆฟ์ง(bridge/, ํ์ค MCP stdio) - ๋ ํ๋ก๊ทธ๋จ์
127.0.0.1:9877๋ก๋ง ํต์ ํฉ๋๋ค (์ธ๋ถ ์ ์ ์์)
1. ์ค์น โ ๋ช ๋ น ๋ ์ค (Claude Code ๊ธฐ์ค, ๋ค๋ฅธ ํด์ 3์ฅ)
์๋ ๋ช ๋ น์ ์ ๋ถ "ํฐ๋ฏธ๋"์ ์ ๋ ฅํฉ๋๋ค. Claude Code ๋ํ์ฐฝ์ด ์๋๋๋ค.
- Windows: ์์ ๋ฉ๋ด์์ PowerShell ์ ์ฐพ์ ์คํ (๋ช
๋ น ํ๋กฌํํธ
cmd๋ ๋ฉ๋๋ค) - macOS: ํฐ๋ฏธ๋(Terminal) ์ฑ
- Linux: ํฐ๋ฏธ๋
๋จผ์ ์์ด์ผ ํ๋ ๊ฒ (์์ผ๋ฉด ํ ๋ฒ๋ง ์ค์น):
| ํ์ธ ๋ช ๋ น | ์์ ๋ | |
|---|---|---|
| FreeCAD 1.0 ์ด์ | (ํ ๋ฒ์ ์คํํด ๋์ธ์ โ Mod ํด๋๊ฐ ๊ทธ๋ ์๊น๋๋ค) | freecad.org |
| MCP๋ฅผ ์ง์ํ๋ AI ํด โ ์: Claude Code | claude --version |
๊ณต์ ์๋ด๋๋ก ์ค์น ํ ๋ก๊ทธ์ธ. CursorยทVS CodeยทWindsurfยทCodexยทGemini CLI ๋ฑ์ 3์ฅ |
| uv | uv --version |
Windows(PowerShell): powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex" ยท macOS/Linux: curl -LsSf https://astral.sh/uv/install.sh | sh โ ์ค์น ํ ํฐ๋ฏธ๋์ ๋ค์ ์ฝ๋๋ค |
| git | git --version |
Windows: git-scm.com ยท macOS: xcode-select --install |
์ค์น โ ํฐ๋ฏธ๋์ ํ ์ค์ฉ ๋ถ์ฌ ๋ฃ๊ณ Enter:
uvx --from git+https://github.com/WaveSimm/cadxray#subdirectory=bridge cadxray install
claude mcp add --scope user cadxray -- uvx --from git+https://github.com/WaveSimm/cadxray#subdirectory=bridge cadxray
์ฒซ ์ค์ด ์ ๋์จ์ FreeCAD Mod ํด๋์ ๋ณต์ฌํ๊ณ (์ฒ์์ ๋ด๋ ค๋ฐ๋๋ผ 10~30์ด), ๋์งธ ์ค์ด Claude Code์ ๋ฑ๋กํฉ๋๋ค. ๊ทธ๋ค์ FreeCAD๋ฅผ ๊ป๋ค ์ผ๋ฉด ์๋ฒ๊ฐ ์๋์ผ๋ก ๋น๋๋ค(๋ฆฌํฌํธ ๋ทฐ์ [CAD X-ray] ์๋ฒ ์์ http://127.0.0.1:9877 (ํด 36๊ฐ)). ๋์
๋๋ค.
์ด์ ์๋ฌด ํด๋์์๋ ํฐ๋ฏธ๋์ claude๋ฅผ ์ณ์ Claude Code๋ฅผ ์ด๊ณ , 4์ฅ์ฒ๋ผ ๋ง๋ก ์ํค๋ฉด ๋ฉ๋๋ค.
๋งํ๋ฉด (์ญ์ ํฐ๋ฏธ๋์):
uvx --from git+https://github.com/WaveSimm/cadxray#subdirectory=bridge cadxray doctor
์ ๋์จ ์ค์น ์ฌ๋ถ ยท FreeCAD ์๋ฒ ์ฐ๊ฒฐ ยท ๋ฒ์ ๋ถ์ผ์น๋ฅผ ํ๊ธ๋ก ์๋ ค ์ค๋๋ค.
๊ฐ๋ฐ์ ์ค์น (์ ์ฅ์๋ฅผ ์ง์ ๊ณ ์น๋ฉด์ ์ธ ๋):
git clone https://github.com/WaveSimm/cadxray.git && cd cadxray/bridge
uv run cadxray install --dev # ์ฌ๋งํฌ โ ์ฝ๋๋ฅผ ๊ณ ์น๋ฉด ๋ฐ๋ก ๋ฐ์
claude mcp add --scope user cadxray -- uv --directory "<์ด ํด๋์ ์ ๋๊ฒฝ๋ก>" run cadxray
FreeCAD Addon Manager๋ก๋ ๋ฉ๋๋ค: ์ค์ โ ์ฌ์ฉ์ ์ ์ฅ์์ https://github.com/WaveSimm/cadxray ์ถ๊ฐ โ "CAD X-ray" ์ค์น. (๋ธ๋ฆฟ์ง ๋ฑ๋ก์ ๋์งธ ์ค ๊ทธ๋๋ก.)
| OS | ์ ๋์จ์ด ๋ค์ด๊ฐ๋ Mod ํด๋ |
|---|---|
| Windows | %APPDATA%\FreeCAD\v1-1\Mod\ (1.0์ v1-0) |
| macOS | ~/Library/Application Support/FreeCAD/v1-1/Mod/ |
| Linux | ~/.local/share/FreeCAD/v1-1/Mod/ (Flatpakยทsnap์ install --dest ๋ก ์ง์ ) |
์ด ํ๋ก์ ํธ๋ theosib/FreeCAD-MCP-Server์ ์ง๋จ ํด ์ค๊ณ์ neka-nat/freecad-mcp์ ์ ๋์จ ์๋ฒ ํจํด์ ์ฐธ๊ณ ํด ๋ค์ ๋ง๋ ๊ฒ์ ๋๋ค.
2. FreeCAD ์ชฝ ์กฐ์ (๋ณดํต์ ํ ์ผ ์์)
์๋ฒ๋ FreeCAD๋ฅผ ์ผค ๋ ์๋์ผ๋ก ์์๋ฉ๋๋ค. ์ํฌ๋ฒค์น CAD X-ray ๋ฉ๋ด์ ์๋ ๊ฒ:
| ๋ฉ๋ด | ์ฉ๋ |
|---|---|
| Start / Stop Server | ์๋ ์์ยท์ค์ง |
| Auto Start | ์๋์์ ์ผ๊ธฐ/๋๊ธฐ (๊ธฐ๋ณธ ์ผ์ง) |
| Set Portโฆ | ํฌํธ ๋ณ๊ฒฝ (๊ธฐ๋ณธ 9877). ๋ฐ๊พธ๋ฉด claude mcp add ๋ช
๋ น ๋์ --port 9878์ ๋ถ์
๋๋ค |
3. ์ด๋ AI ํด์์ ์ฐ๋ โ MCP๋ฅผ ์ง์ํ๋ ํด์ด๋ฉด ๋ค ๋ฉ๋๋ค
๋ธ๋ฆฟ์ง๋ ํ์ค MCP(stdio) ์๋ฒ๋ผ Claude ๋ง๊ณ ๋ CursorยทVS CodeยทWindsurfยทCodexยทGemini CLI ๋ฑ MCP๋ฅผ ์ง์ํ๋ ์ด๋ ํด์์๋ ๊ฐ์ ๋ช ๋ น์ผ๋ก ๋ถ์ต๋๋ค. FreeCAD ์ชฝ(1์ฅ ์ฒซ์งธ ์ค, ์ ๋์จ ์ค์น)์ ๊ณตํต์ด๊ณ , ์๋๋ ํด๋ณ ๋ฑ๋ก๋ง ๋ค๋ฆ ๋๋ค. ์คํ ๋ช ๋ น์ ์ด๋์๋ ๊ฐ์ต๋๋ค:
uvx --from git+https://github.com/WaveSimm/cadxray#subdirectory=bridge cadxray
| ํด | ๋ฑ๋ก ๋ฐฉ๋ฒ | ํ์ธ |
|---|---|---|
| Claude Code (CLIยท๋ฐ์คํฌํฑ ์ฑ, ์ค์ ๊ณต์ ) | 1์ฅ์ ๋์งธ ์ค claude mcp add --scope user โฆ |
/mcp โ cadxray ยท connected ยท 36 tools |
| Claude Desktop ์ฑํ ์ฑ | claude_desktop_config.json์ ์๋ JSON (์ค์ โ ๊ฐ๋ฐ์ โ ์ค์ ํธ์ง; Windows %APPDATA%\Claude\, macOS ~/Library/Application Support/Claude/) ํ ์ฑ ์์ ์ฌ์์ |
๋ํ์ฐฝ ๋๊ตฌ(๐ง)์ cadxray |
| Cursor | ์ค์ โ MCP โ Add new global MCP server ๋ก ~/.cursor/mcp.json(ํ๋ก์ ํธ๋ง์ด๋ฉด .cursor/mcp.json)์ ์๋ JSON |
์ค์ MCP ๋ชฉ๋ก์ ์ด๋ก ์ + ํด 36๊ฐ |
| VS Code (Copilot ์์ด์ ํธ ๋ชจ๋) | ๋ช
๋ น ํ๋ ํธ โ MCP: Add Server โ Command(stdio) โ ์ ์คํ ๋ช
๋ น. ๋๋ .vscode/mcp.json์ ์๋ VS Code JSON |
Copilot ์ฑํ
๋๊ตฌ ๋ชฉ๋ก์ cadxray |
| Windsurf | ์ค์ โ Cascade โ MCP โ Add server โ ~/.codeium/windsurf/mcp_config.json์ ์๋ JSON |
Cascade ๋๊ตฌ ๋ชฉ๋ก |
| OpenAI Codex CLI | codex mcp add cadxray -- uvx --from git+https://github.com/WaveSimm/cadxray#subdirectory=bridge cadxray (๋๋ ~/.codex/config.toml์ ์๋ TOML) |
codex mcp list |
| Gemini CLI | gemini mcp add cadxray uvx --from git+https://github.com/WaveSimm/cadxray#subdirectory=bridge cadxray (๋๋ ~/.gemini/settings.json์ ์๋ JSON) |
/mcp |
| Cline ยท Roo Code ยท Continue ๋ฑ | ๊ฐ ํ์ฅ์ MCP ์ค์ ํ์ผ์ ์๋ JSON(mcpServers ํ์) |
ํ์ฅ์ MCP ํจ๋ |
ํ์ค JSON (Claude Desktop ยท Cursor ยท Windsurf ยท Gemini CLI ยท Cline ๊ณ์ด ๊ณตํต):
{
"mcpServers": {
"cadxray": {
"command": "uvx",
"args": ["--from", "git+https://github.com/WaveSimm/cadxray#subdirectory=bridge", "cadxray"]
}
}
}
VS Code (.vscode/mcp.json โ ํค๊ฐ servers์
๋๋ค):
{
"servers": {
"cadxray": {
"type": "stdio",
"command": "uvx",
"args": ["--from", "git+https://github.com/WaveSimm/cadxray#subdirectory=bridge", "cadxray"]
}
}
}
Codex CLI (~/.codex/config.toml):
[mcp_servers.cadxray]
command = "uvx"
args = ["--from", "git+https://github.com/WaveSimm/cadxray#subdirectory=bridge", "cadxray"]
๊ณตํต ์ฃผ์:
- Windows์์ "uvx๋ฅผ ์ฐพ์ ์ ์๋ค"๊ณ ํ๋ฉด
"command"์ ์ ์ฒด ๊ฒฝ๋ก๋ฅผ ๋ฃ์ต๋๋ค โ PowerShell์์(Get-Command uvx).Source(๋ณดํตC:\Users\<์ด๋ฆ>\.local\bin\uvx.exe). GUI ์ฑ(Claude DesktopยทCursor)์ ํฐ๋ฏธ๋๊ณผ PATH๊ฐ ๋ฌ๋ผ ์ด ๋ฌธ์ ๊ฐ ์์ฃผ ๋ฉ๋๋ค. - ๋ค๋ฅธ MCP๊ฐ ์ด๋ฏธ ์์ผ๋ฉด
mcpServers(VS Code๋servers) ์์"cadxray"ํญ๋ชฉ๋ง ์ถ๊ฐํฉ๋๋ค. - ํฌํธ๋ฅผ ๋ฐ๊ฟจ์ผ๋ฉด
args๋์"--port", "9878"์ ๋ถ์ ๋๋ค. - ์ฒซ ์คํ์ ๋ธ๋ฆฟ์ง๋ฅผ ๋ด๋ ค๋ฐ๋๋ผ 10~30์ด ๊ฑธ๋ฆฝ๋๋ค. ํด์ด ์ ๋ณด์ด๋ฉด ๊ทธ ๋ค์ ํ ๋ฒ ๋ ์ฐ๊ฒฐํฉ๋๋ค.
- ์ด๋ ํด์ด๋ ๊ฐ์ FreeCAD ์๋ฒ(127.0.0.1:9877)์ ๋ถ์ผ๋ฏ๋ก FreeCAD๋ ํ๋๋ง ์ผ ๋๋ฉด ๋๊ณ , ์ฌ๋ฌ ํด์ ๋์์ ์จ๋ ๋ฉ๋๋ค.
- ์ฌ์ฉ๋ฒ(4์ฅ)์ CLAUDE.md ์ํฌํ๋ก๋ Claude Code์ฉ ํ์ผ์
๋๋ค. ๋ค๋ฅธ ํด์์๋ ํด ์ค๋ช
(docstring)๋ง์ผ๋ก๋ ๋์ํ์ง๋ง, ์ง๋จ ์์๋ฅผ ์๋ ค ์ฃผ๋ ค๋ฉด ๊ทธ ํด์ ๊ท์น ํ์ผ(Cursor
.cursor/rules, CodexAGENTS.md, GeminiGEMINI.md๋ฑ)์ CLAUDE.md์ "์ง๋จ ์ํฌํ๋ก" ๋ถ๋ถ์ ๋ณต์ฌํด ๋ฃ์ผ๋ฉด ๋ฉ๋๋ค.
4. ์ด๋ ๊ฒ ์๋๋ค
๋ฐ๋ผํ๊ธฐ ๊ฐ์ด๋ ์ฌ์ดํธ: https://wavesimm.github.io/cadxray/ โ ์ค์น, ํ ์ ์๋ ๊ฒ, ์ค์ต 11๊ฐ(ํ์ ๊ตฌ๋ฉ ๋ซ๊ธฐ๋ถํฐ STEPยทSTL ๋ค์ ๊ทธ๋ฆฌ๊ธฐ, 2D ๋๋ฉด, 3D ํ๋ฆฐํธ ๊ฒํ , ๊ตฌ์กฐ ํด์๊น์ง), ํ๋กฌํํธ ์์ฑ๋ฒ. ์๋ฌธํ์ /en/. ์ค์ต ํ์ผ์ Release practice-files-v1.
FreeCAD์์ ๋ชจ๋ธ์ ์ด์ด ๋๊ณ Claude Code์ ๋ง๋ก ์ํต๋๋ค.
| ์ด๋ ๊ฒ ๋งํ๋ฉด | Claude๊ฐ ํ๋ ์ผ |
|---|---|
| "์ง๊ธ ์ด๋ฆฐ ๋ชจ๋ธ ๊ตฌ์กฐ ํ์ ํด์ค" | get_document_graph โ Bodyยทํผ์ฒยท์๋ฌ ๊ฐ์ฒด ์์ฝ |
| "Sketch003 ์ ๋นจ๊ฐ์ง ์ง๋จํด์ค" | get_sketch_diagnostics โ ์ถฉ๋ ์ ์ฝ ๋ฒํธ(GUI ํจ๋ ๋ฒํธ์ ๊ฐ์), ๋จ์ ์์ ๋, ์ด๋ฆฐ ๋์ |
| "PETG, 0.6 ๋ ธ์ฆ๋ก ์ํฌํธ ์์ด ๋ฝ๊ฒ ๋ด์ค" | check_printability(profile) โ ๋ฒํธ ๋ชฉ๋ก(์์ ๋ฒฝยท์ค๋ฒํยท๊ตฌ๋ฉ) โ suggest_orientation / apply_print_fixes ๋ก ์ ํ ์ ์ฉ โ ๋ค์ ๊ฒ์ฌ |
| "๊ณ ์ณ์ค" | suggest_sketch_fixes โ ๋ฒํธ ๋ถ์ ํ๋ณด ๋ชฉ๋ก(์: "1. Line5 ๋์ ๊ณผ Arc2 ์์์ ์๊ธฐ โ ์์ ๋ 3โ1") โ ์ฌ์ฉ์๊ฐ ๋ฒํธ ์ ํ โ apply_sketch_fixes |
| "Pad001 ์๋ฌ ์์ธ ์ฐพ์์ ๊ณ ์ณ์ค" | ์ง๋จ โ ์์ธ ์ค๋ช
โ execute_code๋ก ์์ โ tracked_recompute๋ก ํ์ธ |
| "์ด ํ์ ๋ญ๊ฐ ์ด์ํด" | analyze_shape โ ์ ํจ์ฑ, ๋ถํผ, ๋ฉด ๊ตฌ์ฑ, ๊นจ์ง ์ด์ |
| "์ง๊ธ ์ด๋ป๊ฒ ์๊ฒผ๋์ง ๋ณด์ฌ์ค" | get_screenshot(view="iso") โ ์ด๋ฏธ์ง๊ฐ ๋ํ์ ๋ธ |
| "Pad์ Length๊ฐ ์ด๋์ ์ค๋ ๊ฐ์ด์ผ?" | inspect_object โ ํ๋กํผํฐ์ ์์(์คํ๋ ๋์ํธ ์ฐธ์กฐ ๋ฑ) |
| "์ด STEP ํ์ผ ๋ง์ดํ ํ ๋ช ๊ฐ๊ณ ํผ์น ์ผ๋ง์ผ?" | import_step โ find_holes โ ์ง๊ฒฝยท๊ฐ์ยท์ค์ฌยทํผ์น |
| "๋ธ๋ผ์ผ์ด๋ ์ผ์ ๊ฒน์น๋์ง ๋ด์ค" | check_interference โ ๊ฒน์น๋ ๋ถํผ(mmยณ) |
| "์ด๊ฑฐ ์๋ฃจ๋ฏธ๋์ด๋ฉด ๋ช g์ด์ผ?" | get_mass_properties(density=2.7) |
| "์ด๊ฑฐ 2D ๋๋ฉด์ผ๋ก ๋ฝ์์ค" | make_drawing โ 3๋ฉด๋ยท์์ธยท์น์ยท์ฃผ์ยทํ์ ๋์ด ๋ TechDraw ํ์ด์ง + PDF/SVG. inspect_drawing์ผ๋ก ์น์ ๊ฐ ํ์ธ |
| "์ด STL ๋ค์ ๊ทธ๋ ค์ค" | ์ฐธ๊ณ ๋ฉ์๋ฅผ ํฌ๋ช
์ผ๋ก ๋์ฐ๊ณ ๋จ๋ฉด ์ ํผํ
โ build_features(CLAUDE.md "STL โ ํ๋ผ๋ฉํธ๋ฆญ" ์ ์ฐจ, examples/stl_spool_guide_with_m7.py) |
| "์ด STEP ๋ถํ ํ๋ผ๋ฉํธ๋ฆญ์ผ๋ก ๋ค์ ๋ง๋ค์ด์ค" (์ฐฐํ์ผ๋ก) | classify_faces(๋ฉด ์ ์ฒดยท์ฃผ์ถยท๋ ๋์ด) โ section_profile(๋ ๊ฒฝ๊ณ) โ build_features(PadยทGrooveยทPocketยทChamfer๋ฅผ ์์๋๋ก) โ compare_shapes(์๋ณธ๊ณผ ์ฐจ์งํฉ์ผ๋ก ๊ฒ์ฆ) |
ํด ๋ชฉ๋ก
| ํด | ํ๋ ์ผ |
|---|---|
ping |
์ฐ๊ฒฐยทFreeCAD ๋ฒ์ ํ์ธ |
list_documents |
์ด๋ฆฐ ๋ฌธ์ ๋ชฉ๋ก |
get_document_graph |
๊ฐ์ฒด ํธ๋ฆฌยท์์กด๊ด๊ณยท๋ฌธ์ ๊ฐ์ฒด. ์ง๋จ์ ์์์ |
inspect_object |
๊ฐ์ฒด ํ๋์ ๋ชจ๋ ํ๋กํผํฐยท์์ยทํ์ ์์ฝ |
get_sketch_diagnostics |
์ค์ผ์น solve ๊ฒฐ๊ณผ, ์์ ๋, ์ถฉ๋/์ค๋ณต ์ ์ฝ, ์ด๋ฆฐ ๋์ |
analyze_shape |
ํ์ ์ ํจ์ฑยท๋ถํผยท๋ฉด/๋ชจ์๋ฆฌ ๊ตฌ์ฑ |
tracked_recompute |
์ฌ๊ณ์ฐ ์ ํ ๋น๊ต โ ๊ณ ์ณ์ง ๊ฒ / ์๋ก ๊นจ์ง ๊ฒ |
get_screenshot |
3D ๋ทฐ PNG (iso, front, top โฆ 12๊ฐ์ง) |
execute_code |
FreeCAD ์์์ Python ์คํ (์์ ์ฉ) |
reload_handlers |
์ ๋์จ ์ฝ๋ ๋ค์ ์ฝ๊ธฐ (๊ฐ๋ฐ์ฉ) |
import_step |
STEP/IGES ๊ฐ์ ธ์ค๊ธฐ + ์๊ธด ๋ถํ ์์ฝ |
find_holes |
๊ตฌ๋ฉ ์ง๊ฒฝยท์ค์ฌยท๊น์ดยท๊ดํต ์ฌ๋ถ, ์นด์ดํฐ๋ณด์ดยท์นด์ดํฐ์ฑํฌยท์ฑํผยท๋๋ฆด ๋์ ๊ตฌ๋ฉ์ ๋ถ์ฌ์, ๊ฐ์ ์ง๊ฒฝ๋ผ๋ฆฌ ํจํดยทํผ์น. ์ง๋ฆ์ ISO ๋ฏธํฐ๋์ฌ ํ์ ๋์กฐํด thread_hint(M3 ํญ ๋๋ฆด / M6 ๊ดํต โฆ)๋ฅผ ์ถ์ ์ผ๋ก ๋ถ์ |
check_interference |
๋ถํ ์ ์ต์ ๊ฑฐ๋ฆฌยท๊ฐ์ญ ๋ถํผ. ๊ธฐ๋ณธ์ ๋ฌธ์ ์๋ง ๋ด๊ณ , ๋ฐ์ด๋ฉ๋ฐ์ค๊ฐ ๋จ์ด์ง ์์ ๊ณ์ฐ ์์ด ๊ฑด๋๋ |
get_mass_properties |
๋ถํผยทํ๋ฉด์ ยท๋ฌด๊ฒ์ค์ฌยท๊ด์ฑ, ๋ฐ๋๋ฅผ ์ฃผ๋ฉด ์ง๋, stability๋ก ์ ์งยท์ ๋๊ฐ, names+densities๋ก ์ด์
๋ธ๋ฆฌ ํฉ์ฐ(M16) |
classify_faces |
STEP โ ํ๋ผ๋ฉํธ๋ฆญ 1๋จ๊ณ. ๋ฉด๋ง๋ค ์ ์ฒด(ํ๋ฉด/์ํต/์๋ฟ/๊ตฌ/์์ ๊ณก๋ฉด). BSpline ๋ฉด๋ ํ๋ณธ์ ์ฐ์ด ๋ง์ถฐ ๋ณด๋ฏ๋ก "๊ฐ์ง ์์ ๊ณก๋ฉด"์ด ๊ฑธ๋ฌ์ง. ์ฃผ์ถยท๋ ๋์ด(levels)ยท๋ฐ์ง๋ฆ ๋ชฉ๋กยท์ฌ๊ตฌ์ฑ ํ์ (verdict) |
section_profile |
๋์ด์ ๋จ๋ฉด ์ค๊ณฝ์ ์ค์ผ์น์ฉ ์ ๋ถยทํธยท์์ผ๋ก(์ค์ผ์น ๋ก์ปฌ 2D). ๊ตฌ๋ฉยท์นด์ดํฐ๋ณด์ดยท์ฑํผ ์๋ฆฌ๋ 3D์์ ๋ฉ์ด ๋ค ์๋ผ ๋ฐ๊นฅ ์ค๊ณฝ๋ง. BSpline ๊ณก์ ๋ ์ง์ ยท์์ผ๋ก ๋ค์ ํ๋ณ |
build_features |
์ค์ผ์น + Pad/Pocket/Groove/Revolution/Fillet/Chamfer ๋ชฉ๋ก์ Body์ ์์๋๋ก ์๊ณ ํผ์ฒ๋ง๋ค ๊ฒ์ฆ. profile.section์ด๋ฉด ์๋ณธ์ ์ง์ ํธ๋ ์ด์คํด ์ขํ๊ฐ ๋ํ๋ฅผ ์ค๊ฐ์ง ์์. Blockยท๊ตฌ์ฑ์ ๊ณ ์ ยท๊ตฌ์ฑ์ ์ถ ๊ท์น ๋ด์ฅ, params๋ Spreadsheet๋ก |
compare_shapes |
๋ถํผยท๋ฉด์ ยทbbox ์ฐจ + ํผ์ง ์ฐจ์งํฉ ์กฐ๊ฐ์ bbox โ ์ด๋๊ฐ ํ๋ ธ๋์ง ๋ฐ๋ก ์ง์ |
align_shapes |
๊ฐ์ ๋ถํ์ ๋ ์ธ์คํด์ค ์ฌ์ด ๊ฐ์ฒด ๋ณํ(๊ด์ฑ ์ฃผ์ถ + ํ๋ฉด ์ ๊ฒ์ฆ). ์ฌ๊ตฌ์ฑํ Body๋ฅผ Link๋ก ์ฌ๋ฌ ์๋ฆฌ์ ๋์ ๋. ๊ฑฐ์ธ์์ด๋ฉด mirrored |
make_drawing |
2D ๋๋ฉด(M8): BodyยทPartยทLink ๊ทธ๋ฃน โ TechDraw ํ์ด์ง(ISO ํ์ ๋, ์๋ ์ถ์ฒยท๋ฐฐ์น, ์ ๋ฉด/์ฐ์ธก/ํ๋ฉด/๋ฑ๊ฐ/์์ธ) + ์น์(๋ชจ๋ธ ์ ์ ยท์ค๋ฃจ์ฃยท์ ์ฐธ์กฐ, ๊ฐ์ ๋ชจ๋ธ์์ ์ผ; ๋ทฐ ์ด๋ฆยท๋ค๋ฅธ ์น์์ ๊ฒน์น๋ฉด ์๋์ผ๋ก ๋ฐ์ด๋) + ์ฃผ์ + ํ์ ๋ โ PDF/SVG. Link 27๊ฐ ์ด์ ๋ธ๋ฆฌ 5๋ทฐยท์น์ 13๊ฐ 87์ด |
inspect_drawing |
ํ์ด์ง์ ๋ทฐยท์น์ ๊ฐยท์ฃผ์ยทํ์ ๋ ์ฝ๊ธฐ. ๋น ๋ทฐ(๋ชจ์๋ฆฌ 0)ยท๊นจ์ง ์น์(Invalid) ์ฐพ๊ธฐ |
import_mesh |
STL(M9): STL/OBJ/PLY/3MF๋ฅผ ์ฐธ๊ณ ์ฉ Mesh ๊ฐ์ฒด๋ก(ํฌ๋ช ), ๋ซํยท์๊ธฐ๊ต์ฐจ ๊ฒ์ฌ |
analyze_mesh |
๋ฉ์์ ์ฃผ์ถยท๋ ๋ฒจ(๋ ๊ฒฝ๊ณ)ยท๋ ๋ณ ๋จ๋ฉด ์ยท๊ณตํต ์ค์ฌยท๋์ฌ(ํผ์นยท์ธ๊ฒฝยท๊ณจยท๋ฐฉํฅ)ยทverdict. classify_faces์ ๋ฉ์ํ |
section_profile / compare_shapes ๋ฉ์ ์
๋ ฅ |
๋ฉ์ ๋จ๋ฉด ํด๋ฆฌ๋ผ์ธ์ ์ง์ ยท์ํธยท์์ผ๋ก ํผํ
ํด build_features๊ฐ ๊ทธ๋๋ก ๋ฐ์ / ๋ถ๋ฆฌ์ธ ์์ด ๋ฒ์ ๊ด์ ํธ์ฐจ(worst ์ )๋ก ๋น๊ต |
build_features helix op |
๋์ฌยท๋์ ํ(SubtractiveHelix/AdditiveHelix), ์ถ ์ค์ฌยทํผ์นยท๋์ดยท๋ฐฉํฅ |
open_document / save_document |
FCStd ์ด๊ธฐยท์ ์ฅ(๋ค๋ฅธ ํ์ผ ๋ฎ์ด์ฐ๊ธฐ๋ overwrite ํ์) |
suggest_sketch_fixes |
์ ์ฝ ์์ ํ๋ณด(M10): ๊ฐ๊น์ด/์ด๋ฆฐ ๋์ ์๊ธฐ, ๋น ์ง ์ํยท์์งยท๊ฐ์, ์ค๋ณตยท์๋ชป๋ยท์ถฉ๋ ์ ์ฝ ์ญ์ , ๋จ์ ์์ ๋์ฉ ์น์. ํ๋ณด๋ง๋ค ์ฌ๋ณธ์ ์ ์ฉํด ๋ณธ ํจ๊ณผ(DoFยท์ํ)์ ํ์ ๋. ์๋์ผ๋ก ๊ณ ์น์ง ์์ |
apply_sketch_fixes |
์ฌ์ฉ์๊ฐ ๊ณ ๋ฅธ ํ๋ณด id๋ง ์ ์ฉ, ๋๋น ์ง๋ฉด ๋๋๋ฆผ. ์ค์ผ์น๊ฐ ๊ทธ์ฌ์ด ๋ฐ๋์์ผ๋ฉด(fingerprint) ๊ฑฐ๋ถ |
check_printability |
3D ํ๋ฆฐํธ(M12): ์ฌ์งยท๋
ธ์ฆยท๋ฒ ๋ ํ๋กํ์ผ๋ก ์์ ๋ฒฝ, ์ค๋ฒํ/๋ธ๋ฆฟ์ง(์ํฌํธ ๋ฉด์ ), ์์ยท์ํ ๊ตฌ๋ฉ, ๋ฒ ๋ ์ ํฉ, ์ฒซ ์ธต ์ ์ง๋ฅผ ๊ฒ์ฌ โ ์ ์ยทissuesยทfix ํ๋ณด. paint=True๋ฉด ๋ฉด์ ๊ฒฐ๊ณผ ์์ผ๋ก |
estimate_print |
์ฌ๋ฃ ๋ถํผยท๋ฌด๊ฒยทํ๋ผ๋ฉํธ ๊ธธ์ดยท๋๋ต ์๊ฐยท๋น์ฉ(์ฌ์ง ๋ฐ๋ ํ) |
suggest_orientation |
์ถ๋ ฅ ๋ฐฉํฅ 6๊ฐ + ํ์ฌ๋ฅผ ์ํฌํธยท์ ์งยท๋์ด๋ก ์ฑ์ , ๊ณ ๋ฅด๋ฉด Placement ์ ์ฉ |
apply_print_fixes |
์ถ๋ ฅ์ฉ ์ค๊ณ ์์ ์ PartDesign ํผ์ฒ๋ก: ์ฝ๋ผ๋ฆฌ๋ฐ ์ฑํผ, ์์ง ๊ตฌ๋ฉ ์ง๋ฆ ๋ณด์ , ์ํ ๊ตฌ๋ฉ ๋๋ฌผ๋ฐฉ์ธ, ์์ ๋ฉด ๋๊ป๊ฒ, ์ค๋ฒํ ์๋ 45ยฐ ์๊ธฐ, ๋ฒ ๋ ์ด๊ณผ ๋ถํ (M15) |
setup_analysis |
๊ตฌ์กฐ ํด์(M13): ์ฌ์ง(ํ ๋๋ Eยทฮฝยท๋ฐ๋ยทํญ๋ณต) + ๊ณ ์ ๋ฉด + ํ์ค(ํยท์๋ ฅยท์์ค) + Gmsh 2์ฐจ ๋ฉ์ + CalculiX ์๋ฒ๋ฅผ ํ ๋ฒ์. ์ฌ๋ฌ ๋ถํ(names, ๋ถํ๋ณ ์ฌ์ง, ์ ํฉ)ยท๊ณ ์ ์ง๋์(analysis_type="frequency")๋(M16) |
run_analysis |
CalculiX ์ ์ ํด์ โ ์ต๋ von Mises ์๋ ฅยท์์น, ์ต๋ ๋ณ์, ์์ ์จ(ํญ๋ณต/์ต๋), verdict, 3D ๋ทฐ์ ์๋ ฅ ์ปฌ๋ฌ๋งต. frequency๋ฉด ๋ชจ๋๋ณ ๊ณ ์ ์ง๋์ |
inspect_results |
์๋ ฅยท๋ณ์ ์์ ์ ์ ๊ณผ ๋ฉด๋ณ ์ต๋, ์ปฌ๋ฌ๋งต ํ๋ ์ ํ |
suggest_reinforcement |
์์ ์จ ๋ฏธ๋ฌ์ด๋ฉด ๋๊ปยทํ๋ ยท๋ฆฌ๋ธยท์ฌ์งยทํ์ค ํ๋ณด๋ฅผ ๋ฒํธ ๋ชฉ๋ก์ผ๋ก(์๋ ์ ์ฉ ์์) |
trace_links |
์ด์ ๋ธ๋ฆฌ Link ์ถ์ (M14): ๋ค๋ฅธ ํ์ผ์ ๊ฐ๋ฆฌํค๋ Linkยท๋ฐฐ์ดยท๋ฐ์ธ๋๋ฅผ ๋ฐ๋ผ ๋ฌธ์ ์ฌ์ฌ, ๊นจ์ง ๋งํฌ(ํ์ผ ์์), ์ฐ๊ฒฐ ๋ฌธ์์ Invalid ๊ฐ์ฒด๋ฅผ ํ ๋ฒ์ |
find_holes๋ ์ค๋ชฉ ์ํต๋ฉด์ ํธ ๊ฐ๋(arc_deg)๋ก ๊ตฌ๋ฉ / ํ๋ / ์ฌ๋กฏ ๋์ ๊ตฌ๋ถํ๊ณ (kind), ๊ฐ์ ์ถ์ด๋ผ๋ ๋จ์ด์ ธ ์๋ ์๋ฆฌํ๊ธฐ๋ ๋ฐ๋ก ์
๋๋ค. patterns๋ ์ง๊ฒฝยท์ถ ๋ฐฉํฅ๋ณ๋ก ๋ฌถ์
๋๋ค.
์์ (execute_code๋ก ์คํ):
examples/rebuild_bracket_from_step.pyโ STEP์ผ๋ก ๋ฐ์ ํ+๊ฐ๊ธฐ๋ฅ ๋ธ๋ผ์ผ์ ๋ฉด ์ธก์ ๊ฐ๋ง์ผ๋ก ํ๋ผ๋ฉํธ๋ฆญ Body(์ค์ผ์น 7ยทPad 2ยทPocket 5ยทFillet 3, ํ๋ผ๋ฏธํฐ 15๊ฐ)๋ก ์ฌ๊ตฌ์ฑ. ์๋ณธ๊ณผ ์ฐจ์งํฉ 0.0 mmยณexamples/step_assembly_to_bodies.pyโ STEP ์ด์ ๋ธ๋ฆฌ(80๋ถํ)๋ฅผ ๋ถํ๋ณ Body + ์ ์ง ์กฐ์ธํธ Assembly๋ก ๋ณํ. 5.7์ด- ๋ฒค๋ ๋ถํ(ํด๋จํ ์กฐ 44๋ฉด, BSpline ์ ์ด๋ฉดยท๋๋ธํ
์ผ ํยท๋ฆฝ ์ฑํผ ํฌํจ)๋ ๊ฐ์ ๋ฐฉ๋ฒ์ผ๋ก ๋ถํผ ์ฐจ 0.0004 %๊น์ง ์ฌ๊ตฌ์ฑํ์ต๋๋ค. ๊ทธ ๊ณผ์ ์์ ํ์ธํ ํจ์ (ํธ๋ ์ด์ค ๊ธฐํ๋ Block์ผ๋ก, 2D ๋ถ๋ฆฌ์ธ ํํผ, 1e-5 ํ ๋ซ๊ธฐ, ํ์ ์ ์ญ์ ๊ณผ์ ์ญ ๋ณต์)์
docs/api-notes.md7.5์ ์ ์์ต๋๋ค - ์ด์
๋ธ๋ฆฌ ์ ์ฒด ์ฌ๊ตฌ์ฑ โ ๋ฒค๋ STEP 80๋ถํ(20์ข
)์ ์ ๋ถ ํ๋ผ๋ฉํธ๋ฆญ Body๋ก ๋ค์ ๋ง๋ค๊ณ (
examples/rebuild_*_with_tools.py), ์ข ๋ฅ๋น Body ํ๋์ ์ธ์คํด์ค 80๊ฐ๋ฅผalign_shapes๋ก ๋ฐฐ์นํ Link + Assembly๋ก ์กฐ๋ฆฝ(examples/assemble_from_bodies.py). 20์ข ์ค identical 15 ยท match 4 ยท 0.14 % 1(์์ ๊ณก๋ฉด ํ๋ ), ์ธ์คํด์ค 80๊ฐ ์ ๋ถ ๋ฐฐ์นยท์ ์ง, ๊ฐ์ญ 0(์ ์ด 9์), 3.5๋ถ. STEP์ Placement๋ ์ธ์คํด์ค ๋ณํ์ด ์๋๋ผ์ ํ์์์ ๊ฐ์ฒด ๋ณํ์ ์ฐพ๋align_shapes๊ฐ ํ์ํ๊ณ , Dํ ์บก๊ณผ ์คํ์ด์์ ๊ฑฐ์ธ์ ์ธ์คํด์ค๊ฐ ์์ฌ ์๋ค๋ ๊ฒ๋ ์ด ๊ณผ์ ์์ ๋๋ฌ๋ฌ์ต๋๋ค examples/techdraw_page_from_assembly.pyโ ์ฒ ๋ด ํ๋ ์ ์ด์ ๋ธ๋ฆฌ์ TechDraw ํ์ด์ง๋ฅผ ์์ผ๋ก ๋ง๋ ๊ธฐ๋ก(M8make_drawing์ ์ํ).examples/pole_frame_from_dxf.pyยทcover_from_pdf_drawing.pyยทpcb_from_dxf.pyยทink_holder_from_photo.pyโ DXFยท๋ฒกํฐ PDFยท์ฌ์ง(์กฐ๊ฐ๋)์์ 3D๋ฅผ ๋ง๋ ๊ธฐ๋กexamples/rebuild_2b2_with_tools.pyโ ๊ฐ์ ํด๋จํ ์กฐ๋ฅผ M7 ํด ๋ค ๊ฐ๋ง์ผ๋ก ๋ค์ ๋ง๋ ๊ธฐ๋ก. ์์ผ๋ก ์ฐ๋ 200์ค์ด ํผ์ฒ 12๊ฐ ๋ชฉ๋ก ํ๋๊ฐ ๋๊ณ , ์ค์ผ์น 12๊ฐ ์ ๋ถ DoF 0,compare_shapesํ์ identical(๋ถํผ ์ฐจ 0.0004 %). BSpline ์ ์ด๋ฉด 8๊ฐ๋classify_faces๊ฐ ์๋ฟ(์ถยท๊ผญ์ง์ ยท๋ฐ๊ฐ 59.63ยฐ)๋ก ํ๋ณํ์ต๋๋ค. ๊ทธ๋ ํ์ธํ ๊ฒ(๋ฒ์ ๋ถํธ ๋ค์งํ,common()์ ๊ฒน์น ๋ฉด, ๊ตฌ์ฑ์ ์ผ๋ก ํธ ๊ณ ์ , ๋ฐ์ง๋ฆ ๋ฐ์ฌ๋ฆผ์ ๋๊ฐ)์ 13์
STL/OBJ๋ ๊ตฌ๋ฉยท๊ฐ์ญ ํด์ด ์ง์ ๋ชป ์ฝ์ง๋ง(๋ฉดยท์๋ฆฌ๋ ์์), M9 ํด๋ก ๋ค์ ๊ทธ๋ฆด ์ ์์ต๋๋ค: import_mesh โ analyze_mesh(๋ ๋ฒจยท๋จ๋ฉด ์ยท๋์ฌ) โ section_profile(๋ฉ์ ๋จ๋ฉด ํผํ
) โ build_features(profile.section์ ๋ฉ์ ์ด๋ฆ, ๋์ฌ๋ helix op) โ compare_shapes(๋ฉ์, Body: ๊ด์ ํธ์ฐจ). 3D ํ๋ฆฐํธ์ฉ ์คํ ๊ฐ์ด๋ STL(5,758๋ฉด)์ ์ด ์ ์ฐจ๋ก ๋ฉ์ ์ ์ ์ ๋ถ 0.03 mm ์, ๋ถํผ 0.014 %๋ก ์ฌ๊ตฌ์ฑํ์ต๋๋ค(์๋์ฌ M44.5ร2 ํฌํจ, examples/stl_spool_guide_with_m7.py). makeShapeFromMesh๋ก ๋ง๋ ์๋ฆฌ๋์ ์์ ๋ฐฉ์ compare_shapes๋ฅผ ๋ถ๋ฅด๋ฉด ๋ถ๋ฆฌ์ธ์ด 10๋ถ ๋๊ฒ ๊ฑธ๋ฆฌ๋ฏ๋ก ๋ฉ์ ์ด๋ฆ์ ๊ทธ๋๋ก ๋๊ธฐ์ธ์. ๋ฒค๋์๊ฒ STEP์ ๋ฐ์ผ์ธ์.
๋ชจ๋ ์๋ต์ {"ok", "data", "warnings", "truncated", "elapsed_ms"} ๋ดํฌ์ด๊ณ , ๋ชฉ๋กํ ์๋ต์ max_* ์ธ์๋ก ํฌ๊ธฐ๋ฅผ ์กฐ์ ํฉ๋๋ค. ์์ฝ(summary, invalid_objects)์ ์๋ ค๋ ํญ์ ์ ์ฒด ๊ธฐ์ค์
๋๋ค.
5. ์๋ต ํฌ๊ธฐยท์๊ฐ (FreeCAD 1.1.3, Windows)
tests/in_freecad/test_handlers.py๊ฐ ๋ง๋๋ ํ
์คํธ ๋ชจ๋ธ๊ณผ ์ค์ ๋ถํ ๋ชจ๋ธ(31๊ฐ์ฒด)์์ ์ธก์ ํ ๊ฐ์
๋๋ค.
| ํด | ๊ฒฝ์ฐ | ์๋ต ํฌ๊ธฐ | ์๊ฐ |
|---|---|---|---|
ping |
โ | 190 B | 0 ms |
get_document_graph |
13๊ฐ์ฒด | 2.8 KB | 0 ms |
get_document_graph |
์ค์ ๋ถํ 31๊ฐ์ฒด | 7.1 KB | 2 ms |
get_document_graph |
320๊ฐ์ฒด, max_objects=50 |
10.5 KB (truncated) | 1 ms |
get_document_graph |
320๊ฐ์ฒด, ๊ธฐ๋ณธ max_objects=200 |
31.7 KB (truncated) | 3 ms |
inspect_object |
Pad | 3.5 KB | 2 ms |
analyze_shape |
Pocket (๊ตฌ๋ฉ ์๋ ๋ธ๋ก) | 2.6 KB | 7 ms |
get_sketch_diagnostics |
์์ ๊ตฌ์ / ์ถฉ๋ ์ ์ฝ | 3.7 / 4.3 KB | 0 ms |
tracked_recompute |
13๊ฐ์ฒด ์ ์ฒด | 0.5 KB | 8 ms |
get_screenshot |
800ร600 | 12 KB | 430 ms |
get_screenshot |
2400ร1800, 320๊ฐ์ฒด | 194 KB | 470 ms |
import_step |
๋ถํ 4๊ฐ STEP (์ ๋ฌธ์ / ๊ธฐ์กด ๋ฌธ์) | 1.7 KB | 85 / 41 ms |
find_holes |
ร6.6 ร 4 ํ | 1.4 KB | 3 ms |
find_holes |
๋ฒค๋ STEP 58๋ฉด(BSpline 49) / 46๋ฉด(์ํต 28) | 1.6 / 5.6 KB | 422 / 44 ms |
check_interference |
๋ถํ 4๊ฐ = 6์ | 1.4 KB | 31 ms |
check_interference |
๋ฒค๋ STEP 2๊ฐ (๊ฒน์นจ โ common() ํธ์ถ) |
0.8 KB | 838 ms |
check_interference |
๋ฒค๋ ์ด์ ๋ธ๋ฆฌ 80๋ถํ = 3,160์ (bbox๋ก 2,989์ ๊ฑด๋๋) | 2.2 KB | 6.5 s |
find_holes |
์ด์ ๋ธ๋ฆฌ ๋ถํ 100๋ฉด (๊ตฌ๋ฉ 20 + ํ๋ 7) | 5 KB | 112 ms |
get_mass_properties |
๊ตฌ๋ฉ ๋ซ๋ฆฐ ํ / ๋ฒค๋ STEP / ์ด์ ๋ธ๋ฆฌ 80๋ถํ | 0.7 KB | 2 / 135 / 2068 ms |
classify_faces |
์ ๋ถ BSpline์ธ ํ 14๋ฉด / ๋ฒค๋ ํด๋จํ ์กฐ 44๋ฉด(BSpline 8) | 5.4 / 12 KB | 25 / 73 ms |
section_profile |
ํ๋ณด ๋์ด๋ง / z=3 ๋จ๋ฉด(๊ตฌ๋ฉ ๋ฉ์) | 0.7 / 1.0 KB | 25 / 65 ms |
build_features |
ํ 5ํผ์ฒ / ํด๋จํ ์กฐ 12ํผ์ฒ(๋จ๋ฉด ํธ๋ ์ด์ค 5ํ ํฌํจ) | 1.2 / 2.5 KB | 180 ms / 2.0 s |
compare_shapes |
ํ vs ์ฌ๊ตฌ์ฑ / ํด๋จํ ์กฐ vs ์ฌ๊ตฌ์ฑ | 0.8 KB | 26 / 780 ms |
์๋ต ํ๋์บก์ 100 KB์
๋๋ค(์คํฌ๋ฆฐ์ท ์ ์ธ). ๋์ผ๋ฉด ํธ๋ค๋ฌ๊ฐ ๋ชฉ๋ก์ ๋จผ์ ์ค์ด๊ณ warnings์ ์๋ฆฝ๋๋ค.
6. ๋ฌธ์ ํด๊ฒฐ
"FreeCAD์ ์ฐ๊ฒฐํ ์ ์์ต๋๋ค(127.0.0.1:9877)"
FreeCAD๊ฐ ๊บผ์ ธ ์๊ฑฐ๋ ์๋ฒ๊ฐ ์ ๋ด์ต๋๋ค. ๋จผ์ cadxray doctor(1์ฅ์ ๊ธด ๋ช
๋ น)๋ฅผ ๋๋ฆฌ๋ฉด ์ด๋ ์ชฝ์ธ์ง ์๋ ค ์ค๋๋ค. FreeCAD๊ฐ ์ผ์ ธ ์๋๋ฐ๋ ์ ๋จ๋ฉด ๋ฆฌํฌํธ ๋ทฐ๋ฅผ ๋ณด๊ณ , CAD X-ray โ Auto Start๊ฐ ๊บผ์ ธ ์์ผ๋ฉด ์ผญ๋๋ค.
์ํฌ๋ฒค์น ๋ชฉ๋ก์ "CAD X-ray"๊ฐ ์๋ค
doctor์ 1๋ฒ ํญ๋ชฉ์ด ์ค์น๋ ํด๋์ ๋ฒ์ ์ ๋ณด์ฌ ์ค๋๋ค. ํด๋๊ฐ ์ค์ FreeCAD ๋ฒ์ (v1-0 / v1-1)๊ณผ ๋ง๋์ง FreeCAD ๋์๋ง โ ์ ๋ณด์ ๋์กฐํ๊ณ , ๋ค๋ฅด๋ฉด install --dest "<๋ง๋ Mod ํด๋>".
"ํฌํธ 9877์ ์ด ์ ์์ต๋๋ค"
์ด๋ฏธ ์๋ฒ๊ฐ ๋ ์๊ฑฐ๋ ๋ค๋ฅธ ํ๋ก๊ทธ๋จ์ด ์ฐ๊ณ ์์ต๋๋ค. **Set Portโฆ**๋ก ๋ฐ๊พธ๊ณ claude mcp add ๋ช
๋ น ๋์ --port 9878์ ๋ถ์ฌ ๋ค์ ๋ฑ๋กํฉ๋๋ค.
ํด์ด 10๊ฐ๋ณด๋ค ์ ๊ฒ ๋ณด์ธ๋ค / ์ ํด์ด ์ ๋ณด์ธ๋ค
๋ธ๋ฆฟ์ง๊ฐ ์ ๋ชฉ๋ก์ ๋ค๊ณ ์๋ ๊ฒ์
๋๋ค. Claude Code์์ /mcp โ cadxray โ Reconnect.
FreeCAD๊ฐ ๋ฉ์ท๋ค
execute_code๋ก ๊ธด ์ฝ๋๋ฅผ ๋๋ฆฐ ๊ฒ์
๋๋ค. ๋ฉ์ธ ์ค๋ ๋์์ ์คํ๋๋ฏ๋ก ์ค๋จํ ์ ์์ต๋๋ค โ ๋๋๊ธธ ๊ธฐ๋ค๋ฆฌ๊ฑฐ๋ FreeCAD๋ฅผ ๊ฐ์ ์ข
๋ฃํฉ๋๋ค. ์ฝ๋๋ฅผ ์งง๊ฒ ๋๋ ์ ์ํค์ธ์.
์ ๋์จ ์ฝ๋๋ฅผ ๊ณ ์ณค๋๋ฐ ๋ฐ์์ด ์ ๋๋ค
handlers/*.py๋ reload_handlers ํด๋ก ๋ค์ ์ฝํ๋๋ค. InitGui.pyยทgui.pyยทrpc_server.pyยทmain_thread.pyยทhandlers/__init__.py๋ FreeCAD ์ฌ์์์ด ํ์ํฉ๋๋ค.
7. ํ ์คํธ
์๋ฒ๋ฅผ ์ผค ํ์ ์์ด FreeCAD ๋ช ๋ น์ค์์ ํธ๋ค๋ฌ๋ฅผ ์ง์ ๋๋ฆฝ๋๋ค (109๊ฐ, 1์ด):
"C:\Program Files\FreeCAD 1.1\bin\freecadcmd.exe" tests\in_freecad\test_handlers.py
macOS๋ /Applications/FreeCAD.app/Contents/MacOS/FreeCADCmd, Linux๋ freecadcmd. GUI๊ฐ ์์ด ์คํฌ๋ฆฐ์ท ํ
์คํธ๋ SKIP๋ฉ๋๋ค. ํ
์คํธ ๋ชจ๋ธ(tests/fixtures/make_test_models.py)์ ๋ฉ๋ชจ๋ฆฌ์๋ง ๋ง๋ค๊ณ ์ ์ฅํ์ง ์์ต๋๋ค.
8. ์ ์ฅ์ ๊ตฌ์ฑ
freecad/cadxray/ FreeCAD ์ ๋์จ (stdlib + PySide๋ง ์ฌ์ฉ)
handlers/ ํด ๊ตฌํ โ ํ์ผ๋ง๋ค TOOLS ์ ์ธ, ์๋ ๋ฑ๋ก
bridge/ MCP ๋ธ๋ฆฟ์ง (์์กด์ฑ: mcp)
scripts/install_addon.py
tests/fixtures/ ํ
์คํธ ๋ชจ๋ธ ์์ฑ
tests/in_freecad/ ํธ๋ค๋ฌ ํ
์คํธ (FreeCADCmd)
docs/api-notes.md FreeCAD 1.0.2ยท1.1.3 API ํ์ธ ๋
ธํธ โ ๊ตฌํ์ ๊ทผ๊ฑฐ
docs/archive/ ์์
์์ ๋ ์ด ์ง์์ (๊ธฐ๋ก์ฉ)
CADXRAY_SPEC.md ๊ฐ๋ฐ ๋ช
์ธ
๋ผ์ด์ ์ค: MIT (LICENSE). ๊ตฌํ ๊ทผ๊ฑฐ๋ก ์ฐธ๊ณ ํ FreeCAD ์์ค ๋ฐ์ท(LGPL-2.1)๋ ์ ์ฅ์์ ๋ฃ์ง ์์์ต๋๋ค โ ๋ฐ๋ ๋ฒ์ CADXRAY_SPEC.md ๋ถ๋ก A.2.
cadxray MCP questions
What can cadxray do with FreeCAD models?
It allows AI to diagnose red sketches, rebuild STEP/STL files parametrically, inspect holes and interference, create 2D drawings, check 3D printability, and run FEM analysis.
Which versions of FreeCAD are supported?
The server supports FreeCAD 1.0.x and 1.1.x, and has been verified on version 1.1.3.
Is the connection secure?
Yes, the two programs communicate only via 127.0.0.1:9877, with no external access.