Claude AI로 FreeCAD를 자연어를 통해 제어하세요!

대화형 AI를 사용해 3D 모델을 만들고, 기능을 추가하며, CAD 워크플로우를 자동화할 수 있습니다.

🎥 직접 보며

FreeCAD MCP가 간단한 텍스트 명령어로 집을 모델링하는 모습을 보세요:

demo-house-modeling.mp4

“FreeCAD에 집을 모델링해 달라고 요청하세요” - 그리고 벽, 지붕, 창문, 문을 자동으로 생성하는 모습을 보세요!

** 🎉 새로워!** 자동 업데이트가 가능한 2-명령어 설치 간편함!

📋 요구 사항

설치 전에 반드시 준비하세요:

• FreeCAD 1.0+ - 여기에서 다운로드
• Node.js & npm - 여기에서 다운로드
• 클로드 코드 - npm install -g claude-code (추천)

Python 3.9+는 FreeCAD에 자동으로 포함되어 있습니다

⚡ 아주 쉬운 설치

🚀 빠른 설치

윈도우:

macOS/Linux:

그거야! 설치 프로그램이 자동으로 말해:

• ✅ 크로스 플랫폼: macOS, Linux, Windows에서 동작
• ✅ 운영체제 및 FreeCAD 설치 감지
• ✅ GitHub에서 최신 FreeCAD MCP 다운로드
• ✅ AI Copilot 작업대를 올바른 위치에 설치함
• ✅ MCP 브리지 서버 다운로드 및 등록
• ✅ 테스트의 명확한 다음 단계 제공

📦 업데이트 중

최신 버전으로 업데이트하기 위해:

윈도우:

macOS/Linux:

FreeCAD MCP - AI-Powered CAD

Control FreeCAD with Claude AI through natural language!

Create 3D models, add features, and automate CAD workflows using conversational AI.

🎥 See It In Action

Watch FreeCAD MCP model a house from a simple text command:

demo-house-modeling.mp4

“Ask FreeCAD to model a house” - and watch it create walls, roof, windows, and door automatically!

🎉 New! Easy 2-command installation with automatic updates!

📋 Requirements

Before installation, make sure you have:

• FreeCAD 1.0+ - Download here
• Node.js & npm - Download here
• Claude Code - npm install -g claude-code (recommended)

Python 3.9+ is included with FreeCAD automatically

⚡ Super Easy Install

🚀 Quick Install

Windows:

python -m pip install --user mcp
npm install -g freecad-mcp-setup@latest
npx freecad-mcp-setup setup

macOS/Linux:

pip install mcp
npm install -g freecad-mcp-setup@latest
npx freecad-mcp-setup setup

That’s it! The installer automatically:

• ✅ Cross-platform: Works on macOS, Linux, and Windows
• ✅ Detects your OS and FreeCAD installation
• ✅ Downloads latest FreeCAD MCP from GitHub
• ✅ Installs the AI Copilot workbench to correct location
• ✅ Downloads and registers MCP bridge server
• ✅ Provides clear next steps for testing

📦 Updating

To update to the latest version:

Windows:

npm update -g freecad-mcp-setup
npx freecad-mcp-setup setup

macOS/Linux:

npm update -g freecad-mcp-setup
npx freecad-mcp-setup setup

The installer will automatically download and install the latest FreeCAD MCP files!

🚀 How to Use

Step 1: Start FreeCAD

1. Launch FreeCAD
2. The AI Copilot service starts automatically

Step 2: Open Claude

In a new terminal/command prompt:

claude

Step 3: Verify Connection

Ask Claude:

Check FreeCAD connection

You should see confirmation that FreeCAD tools are available.

Step 4: Start Creating!

Just ask Claude to design anything - watch the demo video above to see it model a house!

🖥️ Using Claude Desktop?

The installer works with Claude Code by default. For Claude Desktop users, after running the installer, you’ll need to manually configure:

Add to your Claude Desktop config:

macOS/Linux:

{
  "mcpServers": {
    "freecad": {
      "command": "python3",
      "args": ["/Users/yourusername/.freecad-mcp/working_bridge.py"]
    }
  }
}

Windows:

{
  "mcpServers": {
    "freecad": {
      "command": "python3",
      "args": ["C:\\Users\\yourusername\\.freecad-mcp\\working_bridge.py"]
    }
  }
}

Config file locations:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%/Claude/claude_desktop_config.json