Локальный MCP-сервер, который превращает исходный код OpenSCAD или явные примитивные измерения в редактируемый SCAD, STL-геометрию и четыре PNG-предпросмотра. Подключённый помощник может писать SCAD для сложных проектов; этот сервер компилирует и рендерит его с установленным исполняемым файлом OpenSCAD.

Статус: поддерживаемая реализация находится в src/openscad_mcp. Предыдущая генерация изображений, реконструкция CUDA, удаленная обработка и код принтера архивируются в legacy/. Он незавершён и не является частью установленного сервера. См. результаты аудита и машинного тестирования.

Установка

Требуется Python 3.11+ и OpenSCAD. Не требуются API-ключи, CUDA, Open3D или отдельный рендерер изображений.

Установите OpenSCAD, используя официальные загрузки. На macOS доступна текущая нативная сборка Apple Silicon/Intel с такими версиями:

На Debian/Ubuntu sudo apt-get install openscad устанавливает пакет дистрибуции. Для PNG-рендеринга Linux может потребоваться 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