dcc-mcp-openusd 0.1.0__tar.gz

dcc_mcp_openusd-0.1.0/.gitignore

@@ -0,0 +1,15 @@
+__pycache__/
+*.py[cod]
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+.coverage
+htmlcov/
+build/
+dist/
+*.egg-info/
+.venv/
+venv/
+.env
+*.log
+*.usdz

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

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

dcc_mcp_openusd-0.1.0/CHANGELOG.md

@@ -0,0 +1,12 @@
+# Changelog
+
+## 0.1.0 (2026-05-25)
+
+
+### Features
+
+* bootstrap OpenUSD MCP adapter ([03d4931](https://github.com/loonghao/dcc-mcp-openusd/commit/03d4931c2be9325579defd5be9de173babc8a934))
+
+## 0.0.0
+
+Initial development baseline. `release-please` owns public release versions.

dcc_mcp_openusd-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+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. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

dcc_mcp_openusd-0.1.0/PKG-INFO

@@ -0,0 +1,106 @@
+Metadata-Version: 2.4
+Name: dcc-mcp-openusd
+Version: 0.1.0
+Summary: OpenUSD adapter and skills for the DCC Model Context Protocol ecosystem
+Project-URL: Homepage, https://github.com/loonghao/dcc-mcp-openusd
+Project-URL: Repository, https://github.com/loonghao/dcc-mcp-openusd
+Project-URL: Issues, https://github.com/loonghao/dcc-mcp-openusd/issues
+Project-URL: Changelog, https://github.com/loonghao/dcc-mcp-openusd/releases
+Author-email: Long Hao <hal.long@outlook.com>
+License: MIT
+License-File: LICENSE
+Keywords: ai,dcc,llm,mcp,model-context-protocol,openusd,usd
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+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 :: 3D Modeling
+Classifier: Topic :: Multimedia :: Graphics :: 3D Rendering
+Requires-Python: >=3.9
+Requires-Dist: dcc-mcp-core<1.0.0,>=0.17.26
+Provides-Extra: dev
+Requires-Dist: build; extra == 'dev'
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Requires-Dist: pyyaml>=6.0; extra == 'dev'
+Requires-Dist: ruff>=0.8.0; extra == 'dev'
+Requires-Dist: twine; extra == 'dev'
+Provides-Extra: openusd
+Requires-Dist: usd-core<27,>=24.11; extra == 'openusd'
+Description-Content-Type: text/markdown
+
+# dcc-mcp-openusd
+
+OpenUSD adapter and skills for the DCC Model Context Protocol ecosystem.
+
+`dcc-mcp-openusd` runs a headless OpenUSD-oriented MCP server that can create
+portable USD project folders, author simple stages, add references, validate
+stages, and package USDZ-like archives. It is designed to plug into the
+`dcc-mcp-core` gateway and skills-first workflow.
+
+## Install
+
+```bash
+pip install dcc-mcp-openusd
+```
+
+For full OpenUSD runtime behavior, install the optional Pixar USD bindings:
+
+```bash
+pip install "dcc-mcp-openusd[openusd]"
+```
+
+## Run
+
+```bash
+dcc-mcp-openusd --port 8765
+```
+
+Then connect an MCP client to:
+
+```text
+http://127.0.0.1:8765/mcp
+```
+
+## Bundled Skills
+
+The first version ships three bundled skills:
+
+| Skill | Purpose |
+| --- | --- |
+| `openusd-project` | Create self-contained project folders and snapshots. |
+| `openusd-stage` | Create stages, list prims, define xforms, and add references. |
+| `openusd-validate` | Validate stage invariants and package a USDZ-style archive. |
+
+Agents should follow the normal DCC-MCP flow:
+
+1. `search_skills(query="openusd stage")`
+2. `load_skill("openusd-stage")`
+3. Call a typed tool such as `openusd_stage__create_stage`
+4. Validate with `openusd_validate__validate_stage`
+
+## Scope
+
+This repository is intentionally an adapter/domain-skill package, not a new
+core USD engine. `dcc-mcp-core` remains the shared transport, gateway,
+validation, telemetry, and skill-loading foundation. This package owns
+OpenUSD-specific project semantics, stage authoring tools, validation policy,
+and packaging workflows.
+
+## Development
+
+```bash
+pip install -e ".[dev]"
+pytest
+ruff check src tests tools
+python -m build
+```
+
+## Release
+
+The repository uses `release-please`. The baseline version is `0.0.0` so the
+first release PR will cut `v0.1.0`. PyPI publishing is wired through the
+`pypi` GitHub environment.

dcc_mcp_openusd-0.1.0/README.md

@@ -0,0 +1,72 @@
+# dcc-mcp-openusd
+
+OpenUSD adapter and skills for the DCC Model Context Protocol ecosystem.
+
+`dcc-mcp-openusd` runs a headless OpenUSD-oriented MCP server that can create
+portable USD project folders, author simple stages, add references, validate
+stages, and package USDZ-like archives. It is designed to plug into the
+`dcc-mcp-core` gateway and skills-first workflow.
+
+## Install
+
+```bash
+pip install dcc-mcp-openusd
+```
+
+For full OpenUSD runtime behavior, install the optional Pixar USD bindings:
+
+```bash
+pip install "dcc-mcp-openusd[openusd]"
+```
+
+## Run
+
+```bash
+dcc-mcp-openusd --port 8765
+```
+
+Then connect an MCP client to:
+
+```text
+http://127.0.0.1:8765/mcp
+```
+
+## Bundled Skills
+
+The first version ships three bundled skills:
+
+| Skill | Purpose |
+| --- | --- |
+| `openusd-project` | Create self-contained project folders and snapshots. |
+| `openusd-stage` | Create stages, list prims, define xforms, and add references. |
+| `openusd-validate` | Validate stage invariants and package a USDZ-style archive. |
+
+Agents should follow the normal DCC-MCP flow:
+
+1. `search_skills(query="openusd stage")`
+2. `load_skill("openusd-stage")`
+3. Call a typed tool such as `openusd_stage__create_stage`
+4. Validate with `openusd_validate__validate_stage`
+
+## Scope
+
+This repository is intentionally an adapter/domain-skill package, not a new
+core USD engine. `dcc-mcp-core` remains the shared transport, gateway,
+validation, telemetry, and skill-loading foundation. This package owns
+OpenUSD-specific project semantics, stage authoring tools, validation policy,
+and packaging workflows.
+
+## Development
+
+```bash
+pip install -e ".[dev]"
+pytest
+ruff check src tests tools
+python -m build
+```
+
+## Release
+
+The repository uses `release-please`. The baseline version is `0.0.0` so the
+first release PR will cut `v0.1.0`. PyPI publishing is wired through the
+`pypi` GitHub environment.

dcc_mcp_openusd-0.1.0/justfile

@@ -0,0 +1,42 @@
+# dcc-mcp-openusd justfile
+
+set shell := ["sh", "-cu"]
+set windows-shell := ["pwsh.exe", "-NoProfile", "-Command"]
+
+python := "python"
+
+@default:
+    just --list
+
+dev:
+    {{python}} -m pip install -e ".[dev]"
+
+serve:
+    {{python}} -m dcc_mcp_openusd --port 8765
+
+test:
+    {{python}} -m pytest
+
+lint:
+    ruff check src tests tools
+
+format:
+    ruff format src tests tools
+
+lint-format:
+    ruff format --check src tests tools
+
+lint-skills:
+    {{python}} tools/lint_skills.py --warnings-as-errors
+
+build:
+    {{python}} -m build
+
+check-dist: build
+    {{python}} -m twine check dist/*
+
+clean:
+    {{python}} -c "import shutil; [shutil.rmtree(p, ignore_errors=True) for p in ['dist', 'build', 'src/dcc_mcp_openusd.egg-info']]"
+
+preflight: lint lint-format lint-skills test check-dist
+    @echo "preflight passed"

dcc_mcp_openusd-0.1.0/pyproject.toml

@@ -0,0 +1,102 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "dcc-mcp-openusd"
+version = "0.1.0"
+description = "OpenUSD adapter and skills 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"
+keywords = ["openusd", "usd", "mcp", "dcc", "ai", "llm", "model-context-protocol"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "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 :: 3D Modeling",
+    "Topic :: Multimedia :: Graphics :: 3D Rendering",
+]
+
+dependencies = [
+    "dcc-mcp-core>=0.17.26,<1.0.0",
+]
+
+[project.optional-dependencies]
+openusd = [
+    "usd-core>=24.11,<27",
+]
+dev = [
+    "build",
+    "pytest>=7.0",
+    "ruff>=0.8.0",
+    "twine",
+    "pyyaml>=6.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/loonghao/dcc-mcp-openusd"
+Repository = "https://github.com/loonghao/dcc-mcp-openusd"
+Issues = "https://github.com/loonghao/dcc-mcp-openusd/issues"
+Changelog = "https://github.com/loonghao/dcc-mcp-openusd/releases"
+
+[project.scripts]
+dcc-mcp-openusd = "dcc_mcp_openusd.cli:main"
+
+[project.entry-points."dcc_mcp.adapters"]
+openusd = "dcc_mcp_openusd:OpenUsdMcpServer"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/dcc_mcp_openusd"]
+artifacts = [
+    "src/dcc_mcp_openusd/skills/**",
+]
+
+[tool.hatch.build.targets.sdist]
+include = [
+    "src/dcc_mcp_openusd",
+    "tests",
+    "tools",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE",
+    "justfile",
+    "release-please-config.json",
+    ".release-please-manifest.json",
+]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["src"]
+python_files = ["test_*.py"]
+python_classes = ["Test*"]
+python_functions = ["test_*"]
+addopts = "-v --tb=short"
+
+[tool.ruff]
+line-length = 120
+target-version = "py39"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "W", "B", "C4"]
+ignore = [
+    "E501",
+    "B008",
+]
+
+[tool.ruff.lint.isort]
+known-first-party = ["dcc_mcp_openusd"]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/*" = ["S101"]
+"src/dcc_mcp_openusd/skills/**/scripts/*.py" = ["E402"]
+
+[tool.ruff.format]
+quote-style = "double"
+indent-style = "space"

dcc_mcp_openusd-0.1.0/release-please-config.json

@@ -0,0 +1,21 @@
+{
+  "packages": {
+    ".": {
+      "release-type": "python",
+      "package-name": "dcc-mcp-openusd",
+      "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_openusd/__version__.py"
+        }
+      ]
+    }
+  }
+}

dcc_mcp_openusd-0.1.0/src/dcc_mcp_openusd/__init__.py

@@ -0,0 +1,43 @@
+"""OpenUSD adapter and skills for DCC MCP Core."""
+
+from dcc_mcp_openusd.__version__ import __version__
+from dcc_mcp_openusd.runtime import (
+    OpenUsdError,
+    add_reference,
+    create_project,
+    create_stage,
+    define_xform,
+    list_stage,
+    package_usdz,
+    snapshot_stage,
+    validate_stage,
+)
+from dcc_mcp_openusd.server import (
+    DEFAULT_PORT,
+    SERVER_NAME,
+    OpenUsdMcpServer,
+    OpenUsdServerOptions,
+    get_server,
+    start_server,
+    stop_server,
+)
+
+__all__ = [
+    "__version__",
+    "DEFAULT_PORT",
+    "OpenUsdError",
+    "OpenUsdMcpServer",
+    "OpenUsdServerOptions",
+    "SERVER_NAME",
+    "add_reference",
+    "create_project",
+    "create_stage",
+    "define_xform",
+    "get_server",
+    "list_stage",
+    "package_usdz",
+    "snapshot_stage",
+    "start_server",
+    "stop_server",
+    "validate_stage",
+]

dcc_mcp_openusd-0.1.0/src/dcc_mcp_openusd/__main__.py

@@ -0,0 +1,5 @@
+"""Module entry point for ``python -m dcc_mcp_openusd``."""
+
+from dcc_mcp_openusd.cli import main
+
+raise SystemExit(main())

dcc_mcp_openusd-0.1.0/src/dcc_mcp_openusd/__version__.py

@@ -0,0 +1,3 @@
+"""Package version for dcc-mcp-openusd."""
+
+__version__ = "0.1.0"  # x-release-please-version

dcc_mcp_openusd-0.1.0/src/dcc_mcp_openusd/cli.py

@@ -0,0 +1,51 @@
+"""Command-line entry point for dcc-mcp-openusd."""
+
+from __future__ import annotations
+
+import argparse
+import logging
+import sys
+import time
+from typing import Optional
+
+from dcc_mcp_openusd import start_server, stop_server
+
+
+def main(argv: Optional[list[str]] = None) -> int:
+    """Run the OpenUSD MCP server."""
+    parser = argparse.ArgumentParser(description="OpenUSD MCP Server")
+    parser.add_argument("--port", type=int, default=8765, help="Port to listen on")
+    parser.add_argument("--gateway-port", type=int, default=None, help="Gateway port")
+    parser.add_argument("--registry-dir", default=None, help="Optional gateway registry directory")
+    parser.add_argument("--project-dir", default=None, help="Optional active OpenUSD project directory")
+    parser.add_argument("--metrics", action="store_true", help="Enable Prometheus metrics when supported by core")
+    parser.add_argument("--debug", action="store_true", help="Enable debug logging")
+    args = parser.parse_args(argv)
+
+    logging.basicConfig(
+        level=logging.DEBUG if args.debug else logging.INFO,
+        format="%(asctime)s [%(levelname)s] %(name)s: %(message)s",
+    )
+
+    server = start_server(
+        port=args.port,
+        gateway_port=args.gateway_port,
+        registry_dir=args.registry_dir,
+        project_dir=args.project_dir,
+        metrics_enabled=args.metrics,
+    )
+
+    print(f"OpenUSD MCP server started: {server.mcp_url}")
+    print("Press Ctrl+C to stop...")
+
+    try:
+        while True:
+            time.sleep(1)
+    except KeyboardInterrupt:
+        print("\nShutting down...")
+        stop_server()
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())