Claude Desktop 및 기타 MCP 클라이언트에서 FreeCAD를 제어할 수 있습니다. 모델을 생성하고 편집할 수 있습니다. 파이썬 스크립트를 실행하고, 문서를 검사하며, FEM 분석을 수행합니다.

데모

플랜지 설계하기:

장난감 자동차의 더 많은 데모와 예시를 보세요. 2D 드로잉과 에이전트 통합.

퀵 스타트

FreeCAD와 UV/UVX가 필요합니다. FreeCAD MCP는 두 가지 구성 요소로 구성되어 있습니다: FreeCAD 내부에서 실행되는 애드온과 MCP 서버입니다 당신의 고객이 시작한 것입니다.

1. FreeCAD 애드온을 설치하고 시작하세요

FreeCAD 애드온 디렉터리에 addon/FreeCADMCP를 복사하세요, 그 후 FreeCAD를 재시작하세요. MCP 애드온 워크벤치를 선택하고 클릭하세요 FreeCAD MCP 툴바에서 RPC 서버를 시작하세요.

플랫폼별 명령어에 대해서는 설치 가이드를 참조하세요 그리고 스크린샷도 있습니다.

2. Connect Claude Desktop

claude_desktop_config.json에 다음 항목을 추가하세요:

Claude 데스크톱을 재시작해서 설정을 불러오고, FreeCAD를 RPC와 함께 열어두세요 서버가 실행 중이며, Claude에게 모델을 생성하도록 요청합니다. 연결은 localhost를 사용하여 기본이었다.

문서

FreeCAD MCP

Control FreeCAD from Claude Desktop and other MCP clients. Create and edit models, run Python scripts, inspect documents, and run FEM analyses.

Demo

Design a flange:

See more demos and examples for a toy car, modelling from a 2D drawing, and agent integrations.

Quick start

You need FreeCAD and uv / uvx. FreeCAD MCP has two components: an addon running inside FreeCAD and an MCP server launched by your client.

1. Install and start the FreeCAD addon

git clone https://github.com/neka-nat/freecad-mcp.git
cd freecad-mcp

Copy addon/FreeCADMCP into your FreeCAD addon directory, then restart FreeCAD. Select the MCP Addon workbench and click Start RPC Server in the FreeCAD MCP toolbar.

See the installation guide for platform-specific commands and screenshots.

2. Connect Claude Desktop

Add the following entry to claude_desktop_config.json:

{
  "mcpServers": {
    "freecad": {
      "command": "uvx",
      "args": ["freecad-mcp"]
    }
  }
}

Restart Claude Desktop to load the configuration, keep FreeCAD open with its RPC server running, and ask Claude to create a model. Connections use localhost by default.

Documentation

Contributors

Made with contrib.rocks.