dcc-mcp-openscad 0.1.0__tar.gz

dcc_mcp_openscad-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,56 @@
+name: CI
+
+on:
+  workflow_dispatch:
+  push:
+    branches: [main, "release-please--branches--**"]
+  pull_request:
+    branches: [main]
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    name: Test Python ${{ matrix.python }} on ${{ matrix.os }}
+    runs-on: ${{ matrix.os }}
+    timeout-minutes: 15
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - {os: ubuntu-22.04, python: "3.7"}
+          - {os: windows-2022, python: "3.7"}
+          - {os: ubuntu-latest, python: "3.9"}
+          - {os: windows-latest, python: "3.9"}
+          - {os: macos-latest, python: "3.9"}
+          - {os: ubuntu-latest, python: "3.12"}
+          - {os: windows-latest, python: "3.12"}
+          - {os: macos-latest, python: "3.12"}
+    steps:
+      - uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803 # v6
+      - uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1 # v6
+        with:
+          python-version: ${{ matrix.python }}
+      - run: python -m pip install --upgrade pip
+      - run: python -m pip install -e ".[test]"
+      - run: python -m pytest -m "not openscad"
+
+  lint-and-build:
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    steps:
+      - uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803 # v6
+      - uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1 # v6
+        with:
+          python-version: "3.12"
+      - run: python -m pip install --upgrade pip
+      - run: python -m pip install -e ".[dev]"
+      - run: python -m ruff check src tests
+      - run: python -m ruff format --check src tests
+      - run: python -m build
+      - run: python -m twine check dist/*

dcc_mcp_openscad-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,66 @@
+name: Release
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+    inputs:
+      tag_name:
+        description: Existing tag to rebuild and publish
+        required: false
+        default: ""
+      publish_to_pypi:
+        description: Publish a manually rebuilt tag to PyPI
+        type: boolean
+        required: false
+        default: false
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: false
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  release-please:
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    if: github.ref == 'refs/heads/main'
+    outputs:
+      release_created: ${{ steps.release.outputs.release_created }}
+      tag_name: ${{ steps.release.outputs.tag_name || inputs.tag_name }}
+    steps:
+      - uses: googleapis/release-please-action@0dfd8538845b8e92600d271a895a5372865d4062 # v5
+        id: release
+        with:
+          token: ${{ github.token }}
+          config-file: release-please-config.json
+          manifest-file: .release-please-manifest.json
+
+  build-and-publish:
+    needs: release-please
+    if: needs.release-please.outputs.release_created == 'true' || (github.event_name == 'workflow_dispatch' && inputs.tag_name != '' && inputs.publish_to_pypi)
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    environment:
+      name: pypi
+      url: https://pypi.org/p/dcc-mcp-openscad
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803 # v6
+        with:
+          ref: ${{ needs.release-please.outputs.tag_name || inputs.tag_name }}
+      - uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1 # v6
+        with:
+          python-version: "3.12"
+      - run: python -m pip install --upgrade pip build twine
+      - run: python -m build
+      - run: python -m twine check dist/*
+      - uses: pypa/gh-action-pypi-publish@dc37677b2e1c63e2034f94d8a5b11f265b73ba33 # release/v1
+        with:
+          verbose: true
+          print-hash: true

dcc_mcp_openscad-0.1.0/.gitignore

@@ -0,0 +1,8 @@
+__pycache__/
+*.py[cod]
+.pytest_cache/
+.ruff_cache/
+*.egg-info/
+dist/
+build/
+

dcc_mcp_openscad-0.1.0/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.1.0"
+}

dcc_mcp_openscad-0.1.0/CHANGELOG.md

@@ -0,0 +1,9 @@
+# Changelog
+
+## 0.1.0 (2026-08-10)
+
+
+### Features
+
+* add experimental OpenSCAD adapter ([86c0df9](https://github.com/dcc-mcp/dcc-mcp-openscad/commit/86c0df91044b09f2ac0fb174fbff31c084ef408b))
+* make OpenSCAD adapter production ready ([#1](https://github.com/dcc-mcp/dcc-mcp-openscad/issues/1)) ([fe7b4dc](https://github.com/dcc-mcp/dcc-mcp-openscad/commit/fe7b4dce023d61acda6ba8c0c2a798842436dce2))

dcc_mcp_openscad-0.1.0/LICENSE

@@ -0,0 +1,6 @@
+MIT License
+
+Copyright (c) 2026 loonghao
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the Software), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies.
+

dcc_mcp_openscad-0.1.0/PKG-INFO

@@ -0,0 +1,129 @@
+Metadata-Version: 2.4
+Name: dcc-mcp-openscad
+Version: 0.1.0
+Summary: Production OpenSCAD adapter for deterministic DCC-MCP model validation, export, and rendering
+Project-URL: Homepage, https://github.com/dcc-mcp/dcc-mcp-openscad
+Project-URL: Repository, https://github.com/dcc-mcp/dcc-mcp-openscad
+Project-URL: Issues, https://github.com/dcc-mcp/dcc-mcp-openscad/issues
+Author-email: loonghao <hal.long@outlook.com>
+License: MIT
+License-File: LICENSE
+Keywords: automation,cad,dcc,mcp,openscad,parametric-modeling
+Classifier: Development Status :: 4 - Beta
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.7
+Requires-Dist: dcc-mcp-core<1.0.0,>=0.19.91
+Provides-Extra: dev
+Requires-Dist: build>=1.2; extra == 'dev'
+Requires-Dist: pytest<8,>=7.4; (python_version < '3.8') and extra == 'dev'
+Requires-Dist: pytest>=8; (python_version >= '3.8') and extra == 'dev'
+Requires-Dist: pyyaml>=6; extra == 'dev'
+Requires-Dist: ruff>=0.8; extra == 'dev'
+Requires-Dist: twine>=6; extra == 'dev'
+Provides-Extra: test
+Requires-Dist: pytest<8,>=7.4; (python_version < '3.8') and extra == 'test'
+Requires-Dist: pytest>=8; (python_version >= '3.8') and extra == 'test'
+Requires-Dist: pyyaml>=6; extra == 'test'
+Requires-Dist: ruff>=0.8; extra == 'test'
+Description-Content-Type: text/markdown
+
+# dcc-mcp-openscad
+
+<p align="center">
+  <img src="docs/assets/dcc-mcp-openscad.svg" alt="DCC-MCP · OPENSCAD" width="600">
+</p>
+
+Production OpenSCAD adapter for deterministic model inspection, validation,
+geometry export, and PNG rendering through DCC-MCP.
+
+## Capabilities
+
+- Detect the standalone OpenSCAD CLI and report version-specific capabilities.
+- Inspect modules, functions, variables, and `include`/`use` references without
+  executing source.
+- Validate a parameterized model with structured warning/error diagnostics.
+- Export STL (explicit binary or ASCII), 3MF, AMF, OFF, CSG, DXF, SVG, PDF,
+  and OpenSCAD diagnostic formats.
+- Render bounded PNG previews or full geometry renders with typed camera,
+  projection, color-scheme, size, and parameter inputs.
+- Stage outputs atomically and return file size plus SHA-256 provenance.
+
+The adapter does not accept arbitrary OpenSCAD command-line arguments or raw
+`-D` expressions. JSON scalar/array parameters are encoded by the adapter.
+
+## Requirements
+
+- Python 3.7+
+- `dcc-mcp-core` 0.19.91+
+- OpenSCAD 2021.01 or newer
+
+On Windows, point to `openscad.com` when possible; if `openscad.exe` is
+configured and a sibling `openscad.com` exists, the adapter selects the console
+launcher automatically.
+
+## Install
+
+```bash
+python -m pip install dcc-mcp-openscad
+dcc-mcp-openscad
+```
+
+For development:
+
+```bash
+python -m pip install -e ".[dev]"
+python -m pytest
+```
+
+## Configuration
+
+| Variable | Purpose | Default |
+| --- | --- | --- |
+| `DCC_MCP_OPENSCAD_EXECUTABLE` | Exact OpenSCAD executable or install directory | `PATH` and standard install locations |
+| `DCC_MCP_OPENSCAD_ALLOWED_ROOTS` | `os.pathsep`-separated source/output roots | server working directory |
+| `DCC_MCP_OPENSCAD_MAX_SOURCE_BYTES` | Maximum source size | 4 MiB |
+| `DCC_MCP_OPENSCAD_MAX_TIMEOUT_SECS` | Maximum per-call deadline | 1800 seconds |
+| `DCC_MCP_OPENSCAD_PORT` | Fixed adapter port when direct addressing is required | OS-assigned |
+
+The service registers as a standalone DCC-MCP instance. It has no bound GUI
+PID and needs no OpenSCAD window.
+
+## Agent workflow
+
+Use the standard discovery path:
+
+```bash
+dcc-mcp-cli list
+dcc-mcp-cli search --query "OpenSCAD validate export STL"
+dcc-mcp-cli load-skill openscad-pipeline --dcc-type openscad --instance-id <instance-short>
+dcc-mcp-cli describe openscad.<instance-short>.openscad_pipeline__validate_model
+```
+
+Then call `inspect_source` → `validate_model` → `export_model` or
+`render_preview`. Long calls are asynchronous and should be polled through the
+core job tools returned by the call.
+
+`examples/production_smoke.scad` is a parameterized enclosure used by the live
+acceptance test. Override `width`, `depth`, `height`, `wall`, `corner_radius`,
+or `vent_count` to verify safe parameter encoding and reproducible artifacts.
+
+## Safety contract
+
+- Source and output paths must remain under configured allowed roots.
+- Existing outputs are never replaced unless `overwrite=true` is explicit.
+- Exports use sibling temporary files and become visible only after success.
+- Parameter names, values, nesting, count, image dimensions, formats, and
+  deadlines are bounded.
+- Cancellation and timeouts terminate the owned OpenSCAD child process.
+- Captured process output is limited to 64 KiB per stream.
+
+OpenSCAD CLI reference:
+<https://en.wikibooks.org/wiki/OpenSCAD_User_Manual/Using_OpenSCAD_in_a_command_line_environment>

dcc_mcp_openscad-0.1.0/README.md

@@ -0,0 +1,92 @@
+# dcc-mcp-openscad
+
+<p align="center">
+  <img src="docs/assets/dcc-mcp-openscad.svg" alt="DCC-MCP · OPENSCAD" width="600">
+</p>
+
+Production OpenSCAD adapter for deterministic model inspection, validation,
+geometry export, and PNG rendering through DCC-MCP.
+
+## Capabilities
+
+- Detect the standalone OpenSCAD CLI and report version-specific capabilities.
+- Inspect modules, functions, variables, and `include`/`use` references without
+  executing source.
+- Validate a parameterized model with structured warning/error diagnostics.
+- Export STL (explicit binary or ASCII), 3MF, AMF, OFF, CSG, DXF, SVG, PDF,
+  and OpenSCAD diagnostic formats.
+- Render bounded PNG previews or full geometry renders with typed camera,
+  projection, color-scheme, size, and parameter inputs.
+- Stage outputs atomically and return file size plus SHA-256 provenance.
+
+The adapter does not accept arbitrary OpenSCAD command-line arguments or raw
+`-D` expressions. JSON scalar/array parameters are encoded by the adapter.
+
+## Requirements
+
+- Python 3.7+
+- `dcc-mcp-core` 0.19.91+
+- OpenSCAD 2021.01 or newer
+
+On Windows, point to `openscad.com` when possible; if `openscad.exe` is
+configured and a sibling `openscad.com` exists, the adapter selects the console
+launcher automatically.
+
+## Install
+
+```bash
+python -m pip install dcc-mcp-openscad
+dcc-mcp-openscad
+```
+
+For development:
+
+```bash
+python -m pip install -e ".[dev]"
+python -m pytest
+```
+
+## Configuration
+
+| Variable | Purpose | Default |
+| --- | --- | --- |
+| `DCC_MCP_OPENSCAD_EXECUTABLE` | Exact OpenSCAD executable or install directory | `PATH` and standard install locations |
+| `DCC_MCP_OPENSCAD_ALLOWED_ROOTS` | `os.pathsep`-separated source/output roots | server working directory |
+| `DCC_MCP_OPENSCAD_MAX_SOURCE_BYTES` | Maximum source size | 4 MiB |
+| `DCC_MCP_OPENSCAD_MAX_TIMEOUT_SECS` | Maximum per-call deadline | 1800 seconds |
+| `DCC_MCP_OPENSCAD_PORT` | Fixed adapter port when direct addressing is required | OS-assigned |
+
+The service registers as a standalone DCC-MCP instance. It has no bound GUI
+PID and needs no OpenSCAD window.
+
+## Agent workflow
+
+Use the standard discovery path:
+
+```bash
+dcc-mcp-cli list
+dcc-mcp-cli search --query "OpenSCAD validate export STL"
+dcc-mcp-cli load-skill openscad-pipeline --dcc-type openscad --instance-id <instance-short>
+dcc-mcp-cli describe openscad.<instance-short>.openscad_pipeline__validate_model
+```
+
+Then call `inspect_source` → `validate_model` → `export_model` or
+`render_preview`. Long calls are asynchronous and should be polled through the
+core job tools returned by the call.
+
+`examples/production_smoke.scad` is a parameterized enclosure used by the live
+acceptance test. Override `width`, `depth`, `height`, `wall`, `corner_radius`,
+or `vent_count` to verify safe parameter encoding and reproducible artifacts.
+
+## Safety contract
+
+- Source and output paths must remain under configured allowed roots.
+- Existing outputs are never replaced unless `overwrite=true` is explicit.
+- Exports use sibling temporary files and become visible only after success.
+- Parameter names, values, nesting, count, image dimensions, formats, and
+  deadlines are bounded.
+- Cancellation and timeouts terminate the owned OpenSCAD child process.
+- Captured process output is limited to 64 KiB per stream.
+
+OpenSCAD CLI reference:
+<https://en.wikibooks.org/wiki/OpenSCAD_User_Manual/Using_OpenSCAD_in_a_command_line_environment>