FreeCAD MCP

이 저장소는 Claude Desktop에서 FreeCAD를 제어할 수 있게 해주는 FreeCAD MCP입니다.

데모

플랜지 설계

장난감 자동차 설계

2D 도면에서 부품 설계

입력 2D 도면

데모

대화 기록은 다음과 같습니다. https://claude.ai/share/7b48fd60-68ba-46fb-bb21-2fbb17399b48

Related MCP server: FreeCAD MCP

애드온 설치

FreeCAD 애드온 디렉토리는 다음과 같습니다.

• Windows: %APPDATA%\FreeCAD\Mod\

• Mac:

  • FreeCAD 1.1: ~/Library/Application\ Support/FreeCAD/v1-1/Mod/

  • FreeCAD 1.0: ~/Library/Application\ Support/FreeCAD/v1-0/Mod/

• Linux:

  • Ubuntu: ~/.FreeCAD/Mod/ 또는 ~/snap/freecad/common/Mod/ (snap으로 FreeCAD를 설치한 경우)

  • Debian: ~/.local/share/FreeCAD/Mod

addon/FreeCADMCP 디렉토리를 애드온 디렉토리에 넣어주세요.

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

# For Linux (Ubuntu/Debian)
cp -r addon/FreeCADMCP ~/.FreeCAD/Mod/

# For macOS (FreeCAD 1.1)
cp -r addon/FreeCADMCP ~/Library/Application\ Support/FreeCAD/v1-1/Mod/

애드온을 설치한 후에는 FreeCAD를 재시작해야 합니다. 워크벤치 목록에서 "MCP Addon"을 선택하여 사용할 수 있습니다.

그리고 "FreeCAD MCP" 툴바의 "Start RPC Server" 명령으로 RPC 서버를 시작할 수 있습니다.

RPC 서버 자동 시작

기본적으로 RPC 서버는 FreeCAD를 열 때마다 수동으로 시작해야 합니다. 자동으로 시작하려면:

1. FreeCAD MCP 메뉴를 엽니다 (먼저 MCP Addon 워크벤치로 전환하세요)

2. Auto-Start Server를 체크합니다

설정은 freecad_mcp_settings.json에 저장되며 세션 간에 유지됩니다. 다음 FreeCAD 실행 시, 애플리케이션 로딩이 완료되면 RPC 서버가 자동으로 시작됩니다.

같은 메뉴에서 Auto-Start Server 체크를 해제하여 언제든지 비활성화할 수 있습니다.

Claude Desktop 설정

uvx 사전 설치가 필요합니다.

또한 Claude Desktop 설정 파일인 claude_desktop_config.json을 편집해야 합니다.

사용자용.

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

토큰을 절약하려면 only_text_feedback을 true로 설정하여 텍스트 피드백만 사용할 수 있습니다.

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

개발자용. 먼저 이 저장소를 복제해야 합니다.

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

{
  "mcpServers": {
    "freecad": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/freecad-mcp/",
        "run",
        "freecad-mcp"
      ]
    }
  }
}

원격 연결

기본적으로 RPC 서버는 원격 연결을 허용하지 않으며 localhost에서 수신 대기합니다. 네트워크의 다른 기기에서 FreeCAD를 제어하려면:

1. FreeCAD에서 원격 연결 활성화

FreeCAD MCP 툴바에서:

1. Remote Connections를 체크합니다 — 다음 재시작 시 RPC 서버가 0.0.0.0(모든 인터페이스)에 바인딩됩니다. 보안상의 이유로 Allowed IPs 필드에 지정된 IP 주소 또는 CIDR 서브넷에서의 연결만 허용합니다. 기본값은 127.0.0.1입니다.

2. Configure Allowed IPs를 클릭하고 연결을 허용할 IP 주소 또는 CIDR 서브넷을 쉼표로 구분하여 입력합니다. 예:

   192.168.1.100, 10.0.0.0/24

   127.0.0.1은 항상 기본값입니다. 잘못된 항목은 오류 대화 상자와 함께 거부됩니다. 이 설정을 변경한 후에는 RPC 서버를 재시작하세요.

2. 원격 호스트를 가리키도록 MCP 서버 설정

FreeCAD가 실행 중인 기기의 IP 주소나 호스트 이름과 함께 --host 플래그를 전달합니다:

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

--host 값은 시작 시 유효성 검사를 거치며, 유효한 IPv4/IPv6 주소 또는 호스트 이름이어야 합니다.

도구

• create_document: FreeCAD에서 새 문서를 생성합니다.

• create_object: FreeCAD에서 새 객체를 생성합니다.

• edit_object: FreeCAD에서 객체를 편집합니다.

• delete_object: FreeCAD에서 객체를 삭제합니다.

• execute_code: FreeCAD에서 임의의 Python 코드를 실행합니다.

• insert_part_from_library: 부품 라이브러리에서 부품을 삽입합니다.

• get_view: 활성 뷰의 스크린샷을 가져옵니다.

• get_objects: 문서의 모든 객체를 가져옵니다.

• get_object: 문서의 객체를 가져옵니다.

• get_parts_list: 부품 라이브러리의 부품 목록을 가져옵니다.

기여자

contrib.rocks를 사용하여 제작되었습니다.