dcc-mcp-nuke 0.2.0__tar.gz

dcc_mcp_nuke-0.2.0/.github/workflows/ci.yml

@@ -0,0 +1,29 @@
+name: CI
+on:
+  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:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix: {os: [ubuntu-latest, windows-latest, macos-latest], python: ["3.9", "3.11", "3.12"], exclude: [{os: windows-latest, python: "3.9"}, {os: macos-latest, python: "3.9"}]}
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-python@v6
+        with: {python-version: "${{ matrix.python }}"}
+      - run: python -m pip install -e ".[dev]"
+      - run: python -m pytest
+  lint-build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-python@v6
+        with: {python-version: "3.11"}
+      - run: python -m pip install -e ".[dev]"
+      - run: ruff check src tests tools
+      - run: ruff format --check src tests tools
+      - run: python tools/lint_skills.py
+      - run: python -m build && python -m twine check dist/*

dcc_mcp_nuke-0.2.0/.github/workflows/release.yaml

@@ -0,0 +1,25 @@
+name: Release
+on:
+  push: {branches: [main]}
+permissions: {contents: write, pull-requests: write, id-token: write}
+jobs:
+  release-please:
+    runs-on: ubuntu-latest
+    outputs: {release_created: "${{ steps.release.outputs.release_created }}", tag_name: "${{ steps.release.outputs.tag_name }}"}
+    steps:
+      - uses: googleapis/release-please-action@v5
+        id: release
+        with: {token: "${{ secrets.PERSONAL_ACCESS_TOKEN || github.token }}", config-file: release-please-config.json, manifest-file: .release-please-manifest.json}
+  publish:
+    needs: release-please
+    if: needs.release-please.outputs.release_created == 'true'
+    runs-on: ubuntu-latest
+    environment: {name: pypi, url: "https://pypi.org/p/dcc-mcp-nuke"}
+    permissions: {id-token: write}
+    steps:
+      - uses: actions/checkout@v6
+        with: {ref: "${{ needs.release-please.outputs.tag_name }}"}
+      - uses: actions/setup-python@v6
+        with: {python-version: "3.11"}
+      - run: python -m pip install build twine && python -m build && python -m twine check dist/*
+      - uses: pypa/gh-action-pypi-publish@release/v1

dcc_mcp_nuke-0.2.0/.gitignore

@@ -0,0 +1,6 @@
+__pycache__/
+.pytest_cache/
+.ruff_cache/
+build/
+dist/
+*.egg-info/

dcc_mcp_nuke-0.2.0/.release-please-manifest.json

@@ -0,0 +1 @@
+{".":"0.2.0"}

dcc_mcp_nuke-0.2.0/CHANGELOG.md

@@ -0,0 +1,21 @@
+# Changelog
+
+All notable changes to this project are documented in this file.
+
+## [0.2.0](https://github.com/dcc-mcp/dcc-mcp-nuke/compare/v0.1.0...v0.2.0) (2026-07-13)
+
+
+### Features
+
+* add Nuke MCP adapter ([1ff27dd](https://github.com/dcc-mcp/dcc-mcp-nuke/commit/1ff27dd43a6031e754de5a1de7b5372d126d2fe3))
+
+
+### Bug Fixes
+
+* mark package version for release please ([1e31082](https://github.com/dcc-mcp/dcc-mcp-nuke/commit/1e310822ddeef3ac7e25c0594bd096485277e242))
+
+## [0.1.0] - 2026-07-14
+
+### Added
+
+- Initial Nuke MCP adapter with typed script tools.

dcc_mcp_nuke-0.2.0/LICENSE

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) 2026 Long Hao
+
+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 of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.

dcc_mcp_nuke-0.2.0/PKG-INFO

@@ -0,0 +1,43 @@
+Metadata-Version: 2.4
+Name: dcc-mcp-nuke
+Version: 0.2.0
+Summary: Nuke adapter for the DCC Model Context Protocol ecosystem
+Project-URL: Homepage, https://github.com/dcc-mcp/dcc-mcp-nuke
+Project-URL: Repository, https://github.com/dcc-mcp/dcc-mcp-nuke
+Project-URL: Issues, https://github.com/dcc-mcp/dcc-mcp-nuke/issues
+Author-email: Long Hao <hal.long@outlook.com>
+License: MIT
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Multimedia :: Graphics
+Requires-Python: >=3.9
+Requires-Dist: dcc-mcp-core<1.0.0,>=0.19.3
+Provides-Extra: dev
+Requires-Dist: build; extra == 'dev'
+Requires-Dist: pytest>=7; extra == 'dev'
+Requires-Dist: pyyaml>=6; extra == 'dev'
+Requires-Dist: ruff>=0.8; extra == 'dev'
+Requires-Dist: twine; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# dcc-mcp-nuke
+
+Nuke adapter for the DCC Model Context Protocol. It embeds a Streamable HTTP
+MCP server in Nuke and uses Nuke's main-thread execution API for scene tools.
+
+```bash
+python -m pip install dcc-mcp-nuke
+```
+
+Add the installed package's `dcc_mcp_nuke/nuke_plugin` folder to `NUKE_PATH`.
+Nuke loads its `init.py` and serves MCP at `http://127.0.0.1:8765/mcp`.
+
+The bundled `nuke-script` skill inspects scripts and nodes and can explicitly
+save the current script. Releases are published through `release.yaml` and the
+GitHub `pypi` environment.

dcc_mcp_nuke-0.2.0/README.md

@@ -0,0 +1,15 @@
+# dcc-mcp-nuke
+
+Nuke adapter for the DCC Model Context Protocol. It embeds a Streamable HTTP
+MCP server in Nuke and uses Nuke's main-thread execution API for scene tools.
+
+```bash
+python -m pip install dcc-mcp-nuke
+```
+
+Add the installed package's `dcc_mcp_nuke/nuke_plugin` folder to `NUKE_PATH`.
+Nuke loads its `init.py` and serves MCP at `http://127.0.0.1:8765/mcp`.
+
+The bundled `nuke-script` skill inspects scripts and nodes and can explicitly
+save the current script. Releases are published through `release.yaml` and the
+GitHub `pypi` environment.

dcc_mcp_nuke-0.2.0/pyproject.toml

@@ -0,0 +1,41 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "dcc-mcp-nuke"
+version = "0.2.0"
+description = "Nuke adapter for the DCC Model Context Protocol ecosystem"
+authors = [{ name = "Long Hao", email = "hal.long@outlook.com" }]
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.9"
+dependencies = ["dcc-mcp-core>=0.19.3,<1.0.0"]
+classifiers = ["Development Status :: 3 - Alpha", "License :: OSI Approved :: MIT License", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.9", "Programming Language :: Python :: 3.10", "Programming Language :: Python :: 3.11", "Programming Language :: Python :: 3.12", "Topic :: Multimedia :: Graphics"]
+
+[project.optional-dependencies]
+dev = ["build", "pytest>=7", "ruff>=0.8", "twine", "pyyaml>=6"]
+
+[project.urls]
+Homepage = "https://github.com/dcc-mcp/dcc-mcp-nuke"
+Repository = "https://github.com/dcc-mcp/dcc-mcp-nuke"
+Issues = "https://github.com/dcc-mcp/dcc-mcp-nuke/issues"
+
+[project.entry-points."dcc_mcp.adapters"]
+nuke = "dcc_mcp_nuke:NukeMcpServer"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/dcc_mcp_nuke"]
+artifacts = ["src/dcc_mcp_nuke/skills/**", "src/dcc_mcp_nuke/nuke_plugin/**"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["src"]
+
+[tool.ruff]
+line-length = 120
+target-version = "py39"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "W", "B"]
+ignore = ["E501"]

dcc_mcp_nuke-0.2.0/release-please-config.json

@@ -0,0 +1 @@
+{"packages":{".":{"release-type":"python","package-name":"dcc-mcp-nuke","changelog-path":"CHANGELOG.md","include-component-in-tag":false,"extra-files":[{"type":"toml","path":"pyproject.toml","jsonpath":"$.project.version"},{"type":"generic","path":"src/dcc_mcp_nuke/__version__.py"}]}}}

dcc_mcp_nuke-0.2.0/src/dcc_mcp_nuke/__init__.py

@@ -0,0 +1,4 @@
+from dcc_mcp_nuke.__version__ import __version__
+from dcc_mcp_nuke.server import NukeMcpServer, start_server, stop_server
+
+__all__ = ["__version__", "NukeMcpServer", "start_server", "stop_server"]

dcc_mcp_nuke-0.2.0/src/dcc_mcp_nuke/__version__.py

@@ -0,0 +1 @@
+__version__ = "0.2.0"  # x-release-please-version

dcc_mcp_nuke-0.2.0/src/dcc_mcp_nuke/dispatcher.py

@@ -0,0 +1,23 @@
+"""Nuke's native main-thread bridge."""
+
+from __future__ import annotations
+
+import threading
+from typing import Any, Callable
+
+
+class NukeDispatcher:
+    """Route core skill calls into Nuke without managing a second queue."""
+
+    def dispatch_callable(self, func: Callable[..., Any], *args: Any, **kwargs: Any) -> Any:
+        kwargs.pop("context", None)
+        kwargs.pop("action_name", None)
+        kwargs.pop("skill_name", None)
+        kwargs.pop("execution", None)
+        kwargs.pop("timeout_hint_secs", None)
+        kwargs.pop("affinity", kwargs.pop("thread_affinity", None))
+        if threading.current_thread() is threading.main_thread():
+            return func(*args, **kwargs)
+        import nuke  # Lazy import: requires a running Nuke process.
+
+        return nuke.executeInMainThreadWithResult(func, args, kwargs)

dcc_mcp_nuke-0.2.0/src/dcc_mcp_nuke/nuke_plugin/init.py

@@ -0,0 +1,5 @@
+"""Nuke startup entry point; loaded from NUKE_PATH."""
+
+from dcc_mcp_nuke.plugin import initialize
+
+initialize()

dcc_mcp_nuke-0.2.0/src/dcc_mcp_nuke/plugin.py

@@ -0,0 +1,9 @@
+from dcc_mcp_nuke.server import start_server, stop_server
+
+
+def initialize() -> None:
+    start_server()
+
+
+def shutdown() -> None:
+    stop_server()

dcc_mcp_nuke-0.2.0/src/dcc_mcp_nuke/server.py

@@ -0,0 +1,52 @@
+from __future__ import annotations
+
+import os
+from pathlib import Path
+from typing import Optional
+
+from dcc_mcp_core import DccServerOptions, HostExecutionBridge
+from dcc_mcp_core.server_base import DccServerBase
+
+from dcc_mcp_nuke.__version__ import __version__
+from dcc_mcp_nuke.dispatcher import NukeDispatcher
+
+DEFAULT_PORT = 8765
+SERVER_NAME = "dcc-mcp-nuke"
+_server: Optional["NukeMcpServer"] = None
+
+
+class NukeMcpServer(DccServerBase):
+    def __init__(self, port: int = DEFAULT_PORT) -> None:
+        options = DccServerOptions.from_env(
+            "nuke",
+            Path(__file__).resolve().parent / "skills",
+            port=port,
+            server_name=SERVER_NAME,
+            server_version=__version__,
+            execution_bridge=HostExecutionBridge(dispatcher=NukeDispatcher()),
+        )
+        super().__init__(options=options)
+
+    def _version_string(self) -> str:
+        try:
+            import nuke
+
+            return str(nuke.env.get("NukeVersionString", "Nuke"))
+        except Exception:
+            return "Nuke"
+
+
+def start_server(port: Optional[int] = None) -> NukeMcpServer:
+    global _server
+    if _server is None or not _server.is_running:
+        _server = NukeMcpServer(port or int(os.environ.get("DCC_MCP_NUKE_PORT", DEFAULT_PORT)))
+        _server.register_builtin_actions()
+        _server.start()
+    return _server
+
+
+def stop_server() -> None:
+    global _server
+    if _server is not None:
+        _server.stop()
+        _server = None

dcc_mcp_nuke-0.2.0/src/dcc_mcp_nuke/skills/nuke-script/SKILL.md

@@ -0,0 +1,20 @@
+---
+name: nuke-script
+description: >-
+  Host skill - inspect and explicitly save the active Nuke script. Use when
+  checking root settings, selected nodes, or saving a known path. Not for raw Python execution.
+license: MIT
+compatibility: "Nuke Python API; dcc-mcp-core 0.19+"
+allowed-tools: Python
+metadata:
+  dcc-mcp:
+    dcc: nuke
+    version: "0.0.0"
+    layer: domain
+    stage: scene
+    search-hint: "nuke script root selected nodes inspect save nk"
+    tags: "nuke, compositing, nodes, script"
+    tools: tools.yaml
+---
+
+# Nuke Script

dcc_mcp_nuke-0.2.0/src/dcc_mcp_nuke/skills/nuke-script/scripts/inspect_script.py

@@ -0,0 +1,16 @@
+from dcc_mcp_core.skill import skill_entry, skill_success
+
+
+@skill_entry
+def main(**_kwargs):
+    import nuke  # Lazy import: requires Nuke.
+
+    root = nuke.root()
+    selected = nuke.selectedNodes()
+    return skill_success(
+        "Inspected Nuke script",
+        path=nuke.scriptName(),
+        first_frame=root["first_frame"].value(),
+        last_frame=root["last_frame"].value(),
+        selected_nodes=[node.name() for node in selected],
+    )

dcc_mcp_nuke-0.2.0/src/dcc_mcp_nuke/skills/nuke-script/scripts/list_nodes.py

@@ -0,0 +1,9 @@
+from dcc_mcp_core.skill import skill_entry, skill_success
+
+
+@skill_entry
+def main(**_kwargs):
+    import nuke  # Lazy import: requires Nuke.
+
+    nodes = [{"name": node.name(), "class": node.Class()} for node in nuke.allNodes(recurseGroups=True)]
+    return skill_success("Listed Nuke nodes", node_count=len(nodes), nodes=nodes)

dcc_mcp_nuke-0.2.0/src/dcc_mcp_nuke/skills/nuke-script/scripts/save_script.py

@@ -0,0 +1,15 @@
+from pathlib import Path
+
+from dcc_mcp_core.skill import skill_entry, skill_error, skill_success
+
+
+@skill_entry
+def main(path: str, **_kwargs):
+    import nuke  # Lazy import: requires Nuke.
+
+    target = Path(path).expanduser().resolve()
+    if target.suffix.lower() != ".nk":
+        return skill_error("Nuke script path must end in .nk", str(target))
+    target.parent.mkdir(parents=True, exist_ok=True)
+    nuke.scriptSaveAs(str(target))
+    return skill_success("Saved Nuke script", path=str(target))

dcc_mcp_nuke-0.2.0/src/dcc_mcp_nuke/skills/nuke-script/tools.yaml

@@ -0,0 +1,34 @@
+tools:
+  - name: inspect_script
+    description: Inspect the active Nuke script, frame range, and selected nodes without changing it.
+    input_schema: {type: object, properties: {}}
+    read_only: true
+    destructive: false
+    idempotent: true
+    execution: sync
+    affinity: main
+    timeout_hint_secs: 15
+    source_file: scripts/inspect_script.py
+  - name: list_nodes
+    description: List nodes in the current Nuke script without modifying it.
+    input_schema: {type: object, properties: {}}
+    read_only: true
+    destructive: false
+    idempotent: true
+    execution: sync
+    affinity: main
+    timeout_hint_secs: 30
+    source_file: scripts/list_nodes.py
+  - name: save_script
+    description: Save the current Nuke script to an explicit absolute .nk path.
+    input_schema:
+      type: object
+      required: [path]
+      properties: {path: {type: string, description: Absolute .nk output path.}}
+    read_only: false
+    destructive: true
+    idempotent: false
+    execution: sync
+    affinity: main
+    timeout_hint_secs: 60
+    source_file: scripts/save_script.py

dcc_mcp_nuke-0.2.0/tests/test_package.py

@@ -0,0 +1,23 @@
+import json
+import re
+from pathlib import Path
+
+import dcc_mcp_nuke
+
+ROOT = Path(__file__).resolve().parents[1]
+
+
+def test_version_metadata_is_synchronized():
+    version = re.search(r'(?m)^version = "([^"]+)"$', ROOT.joinpath("pyproject.toml").read_text())
+    assert (
+        version
+        and version.group(1)
+        == dcc_mcp_nuke.__version__
+        == json.loads(ROOT.joinpath(".release-please-manifest.json").read_text())["."]
+    )
+
+
+def test_bundled_contract_files_exist():
+    package = ROOT / "src" / "dcc_mcp_nuke"
+    assert package.joinpath("nuke_plugin", "init.py").exists()
+    assert package.joinpath("skills", "nuke-script", "tools.yaml").exists()

dcc_mcp_nuke-0.2.0/tools/lint_skills.py

@@ -0,0 +1,8 @@
+from pathlib import Path
+
+from dcc_mcp_core import validate_skill
+
+paths = [path for path in (Path(__file__).parents[1] / "src" / "dcc_mcp_nuke" / "skills").iterdir() if path.is_dir()]
+reports = [validate_skill(str(path)) for path in paths]
+assert all(report.is_clean for report in reports), [report.issues for report in reports]
+print(f"validated {len(reports)} bundled skills")