개요

FreeCAD MCP(모델 제어 프로토콜)는 서버-클라이언트 아키텍처를 통해 FreeCAD와 상호작용할 수 있는 단순화된 인터페이스를 제공합니다. 이를 통해 사용자는 명령을 실행하고 현재 FreeCAD 문서와 장면에 대한 정보를 검색할 수 있습니다.

https://github.com/user-attachments/assets/5acafa17-4b5b-4fef-9f6c-617e85357d44

구성

MCP 서버를 구성할 때는 JSON 형식을 사용하여 서버 설정을 지정할 수 있습니다. 아래는 예시 구성입니다:

구성 세부사항

• command: FreeCAD MCP 서버를 실행할 Python 실행 파일로 가는 경로입니다. 이는 운영체제에 따라 다를 수 있습니다:

• Windows: 보통 C:\\ProgramData\\anaconda3\\python.exe 또는 C:\\Python39\\python.exe처럼 보일 수 있습니다.

• Linux: /usr/bin/python3 또는 파이썬 설치로 가는 경로일 수 있습니다.

• macOS: 보통은 /usr/local/bin/python3 또는 Python 설치로 가는 경로입니다.

• args: Python 명령어에 전달하는 인수 배열. 첫 번째 인자는 MCP 서버 로직을 처리하는 freecad_bridge.py 스크립트로 가는 경로여야 합니다.

FreeCAD MCP (Model Control Protocol)

Overview

The FreeCAD MCP (Model Control Protocol) provides a simplified interface for interacting with FreeCAD through a server-client architecture. This allows users to execute commands and retrieve information about the current FreeCAD document and scene.

https://github.com/user-attachments/assets/5acafa17-4b5b-4fef-9f6c-617e85357d44

Configuration

To configure the MCP server, you can use a JSON format to specify the server settings. Below is an example configuration:

{
    "mcpServers": {
        "freecad": {
            "command": "C:\\ProgramData\\anaconda3\\python.exe",
            "args": [
                "C:\\Users\\USER\\AppData\\Roaming\\FreeCAD\\Mod\\freecad_mcp\\src\\freecad_bridge.py"
            ]
        }
    }
}

Configuration Details

• command: The path to the Python executable that will run the FreeCAD MCP server. This can vary based on your operating system:

  • Windows: Typically, it might look like C:\\ProgramData\\anaconda3\\python.exe or C:\\Python39\\python.exe.
  • Linux: It could be /usr/bin/python3 or the path to your Python installation.
  • macOS: Usually, it would be /usr/local/bin/python3 or the path to your Python installation.

• args: An array of arguments to pass to the Python command. The first argument should be the path to the freecad_bridge.py script, which is responsible for handling the MCP server logic. Make sure to adjust the path according to your installation.

Example for Different Operating Systems

Windows

{
    "mcpServers": {
        "freecad": {
            "command": "C:\\ProgramData\\anaconda3\\python.exe",
            "args": [
                "C:\\Users\\USER\\AppData\\Roaming\\FreeCAD\\Mod\\freecad_mcp\\src\\freecad_bridge.py"
            ]
        }
    }
}

Linux

{
    "mcpServers": {
        "freecad": {
            "command": "/usr/bin/python3",
            "args": [
                "/home/USER/.FreeCAD/Mod/freecad_mcp/src/freecad_bridge.py"
            ]
        }
    }
}

macOS

{
    "mcpServers": {
        "freecad": {
            "command": "/usr/local/bin/python3",
            "args": [
                "/Users/USER/Library/Preferences/FreeCAD/Mod/freecad_mcp/src/freecad_bridge.py"
            ]
        }
    }
}

Features

The FreeCAD MCP currently supports the following functionalities:

1. get_scene_info

• Description: Retrieves comprehensive information about the current FreeCAD document, including:
  • Document properties (name, label, filename, object count)
  • Detailed object information (type, position, rotation, shape properties)
  • Sketch data (geometry, constraints)
  • View information (camera position, direction, etc.)

2. run_script