OpenSCAD 소스 또는 명시적 원시 차원을 편집 가능한 SCAD, STL 기하학, 그리고 네 개의 PNG 미리보기로 변환하는 로컬 MCP 서버입니다. 연결된 어시스턴트는 복잡한 설계에 대해 SCAD를 작성할 수 있으며; 이 서버는 설치된 OpenSCAD 실행 파일로 컴파일하고 렌더링합니다.

상태: 지원되는 구현은 src/openscad_mcp에 있습니다. 이전 이미지 생성, CUDA 재구성, 원격 처리, 프린터 코드는 legacy/에 아카이브되어 있습니다. 이 코드는 미완성이며 설치된 서버의 일부가 아닙니다. 감사 및 기계 테스트 결과를 참조하세요.

설치

Python 3.11+와 OpenSCAD가 필요합니다. API 키, CUDA, Open3D, 또는 별도의 이미지 렌더러는 필요하지 않습니다.

공식 다운로드를 통해 OpenSCAD를 설치하세요. macOS에서는 현재 애플 실리콘/인텔 네이티브 빌드가 다음과 같이 제공됩니다:

Debian/Ubuntu에서는 sudo apt-get install openscad가 배포판 패키지를 설치합니다. Linux PNG 렌더링은 X 디스플레이가 필요할 수 있으며; 서버 주변에서 xvfb-run -a를 사용하거나 헤드리스 머신에서 테스트할 수 있습니다. Windows 사용자는 OPENSCAD_EXECUTABLE를 openscad.exe의 전체 경로로 설정할 수 있습니다.

또는 python -m pip install .로 가상 환경에 설치하고 openscad-mcp를 실행하세요. '요구사항.

OpenSCAD MCP Server

A local MCP server that turns OpenSCAD source or explicit primitive dimensions into editable SCAD, STL geometry, and four PNG previews. The connected assistant can write SCAD for complex designs; this server compiles and renders it with the installed OpenSCAD executable.

Status: the supported implementation is in src/openscad_mcp. The previous image generation, CUDA reconstruction, remote processing, and printer code is archived in legacy/. It is unfinished and is not part of the installed server. See the audit and machine test results.

Install

Requires Python 3.11+ and OpenSCAD. No API keys, CUDA, Open3D, or separate image renderer are required.

Install OpenSCAD using the official downloads. On macOS, the current native Apple Silicon/Intel build is available with:

brew install --cask openscad@snapshot
openscad --version

On Debian/Ubuntu, sudo apt-get install openscad installs the distribution package. Linux PNG rendering may need an X display; use xvfb-run -a around the server or tests on a headless machine. Windows users can set OPENSCAD_EXECUTABLE to the full path of openscad.exe.

git clone https://github.com/jhacksman/OpenSCAD-MCP-Server.git
cd OpenSCAD-MCP-Server
uv sync --locked
uv run openscad-mcp --help

Alternatively, install into a virtual environment with python -m pip install . and run openscad-mcp. requirements.txt installs this same package. uv.lock pins the tested dependency resolution; the project metadata permits compatible updates.

On an external filesystem that cannot create symlinks, put the environment on the internal disk:

export UV_PROJECT_ENVIRONMENT="$HOME/.cache/openscad-mcp-venv"
uv sync --locked

Docker and Jetson

A headless stdio image is available through the root Dockerfile. See Docker setup and verification for build commands, MCP client configuration, persistent model storage, and Glama listing requirements. The image needs no GPU.

For the hardware question in issue #19, see Jetson Orin Nano and CUDA. The supported server does not use CUDA; the archived reconstruction prototype is not restored by this Docker support.

Connect an MCP client

Stdio is the default. Configure the client to launch the server process, using absolute paths:

{
  "mcpServers": {
    "openscad": {
      "command": "/absolute/path/to/venv/bin/openscad-mcp",
      "args": ["--output-dir", "/absolute/path/to/models"]
    }
  }
}

For clients supporting Streamable HTTP:

uv run openscad-mcp --transport http --port 8000

The MCP endpoint is http://127.0.0.1:8000/mcp. / is server information; /health reports the OpenSCAD version and primitive defaults. HTTP also serves preview pages and downloads. In stdio mode, use returned absolute file paths or get_model_preview; there is no HTTP listener.

Tools