dcc-mcp-openscreen 0.1.1__py3-none-any.whl

dcc_mcp_openscreen/__init__.py

@@ -0,0 +1,2 @@
+from .server import OpenScreenMcpServer
+__all__ = ["OpenScreenMcpServer"]

dcc_mcp_openscreen/server.py

@@ -0,0 +1,20 @@
+"""Standalone OpenScreen MCP adapter."""
+from __future__ import annotations
+import argparse, os, signal, threading
+from pathlib import Path
+from dcc_mcp_core import DccServerOptions
+from dcc_mcp_core.server_base import DccServerBase
+class OpenScreenMcpServer(DccServerBase):
+    def __init__(self, *, port: int | None = None):
+        options = DccServerOptions.from_env("openscreen", Path(__file__).parent / "skills", port=port, server_name="dcc-mcp-openscreen", instance_type="standalone", adapter_version="0.1.0", standalone_main_thread=False)
+        super().__init__(options=options)
+def main(argv=None):
+    p=argparse.ArgumentParser(); p.add_argument("--mcp-port", type=int); a=p.parse_args(argv)
+    server=OpenScreenMcpServer(port=a.mcp_port); server.register_builtin_actions(); server.start()
+    stopped=threading.Event(); signal.signal(signal.SIGINT, lambda *_: stopped.set())
+    if hasattr(signal,"SIGTERM"): signal.signal(signal.SIGTERM, lambda *_: stopped.set())
+    try: stopped.wait()
+    finally: server.stop()
+
+if __name__ == '__main__':
+    main()

dcc_mcp_openscreen/skills/openscreen/scripts/_client.py

@@ -0,0 +1,47 @@
+from __future__ import annotations
+import json, os, subprocess, time
+from pathlib import Path
+
+def executable() -> str:
+    return os.getenv("DCC_MCP_OPENSCREEN_PATH", "openscreen")
+
+def _events(stdout: str) -> list[dict]:
+    out=[]
+    for line in stdout.splitlines():
+        try: out.append(json.loads(line))
+        except json.JSONDecodeError: pass
+    return out
+
+def run(args: list[str], *, timeout: float = 900.0) -> dict:
+    try:
+        proc=subprocess.run([executable(), *args, "--json"], capture_output=True, text=True, timeout=timeout, check=False)
+    except subprocess.TimeoutExpired as exc:
+        raise RuntimeError(f"OpenScreen CLI timed out after {timeout:.0f}s; verify permissions and headless build") from exc
+    return _finish(proc.returncode, proc.stdout, proc.stderr)
+
+def record(args: list[str], *, duration: int, timeout: float) -> dict:
+    proc=subprocess.Popen([executable(), "record", *args, "--json"], stdin=subprocess.PIPE, stdout=subprocess.PIPE, stderr=subprocess.PIPE, text=True)
+    try:
+        time.sleep(duration)
+        if proc.poll() is None and proc.stdin:
+            proc.stdin.write("stop\n"); proc.stdin.flush()
+        stdout, stderr=proc.communicate(timeout=max(10.0, timeout-duration))
+    except subprocess.TimeoutExpired as exc:
+        if os.name == "nt":\n            subprocess.run(["taskkill", "/PID", str(proc.pid), "/T", "/F"], capture_output=True, check=False)\n        else:\n            proc.kill()\n        proc.communicate()
+        raise RuntimeError("OpenScreen recording did not stop after a cooperative stop request") from exc
+    return _finish(proc.returncode, stdout, stderr)
+
+def _finish(code: int, stdout: str, stderr: str) -> dict:
+    events=_events(stdout)
+    done=next((e for e in reversed(events) if e.get("event")=="done"), None)
+    if code != 0 or not done or done.get("success") is False:
+        detail=(stderr or "OpenScreen command failed").strip()
+        if not events and not detail: detail="OpenScreen produced no JSON events; verify a headless-capable build"
+        raise RuntimeError(detail[-2000:])
+    return done
+
+def path_arg(value: str) -> str:
+    path=Path(value).expanduser().resolve()
+    if len(str(path))>4096: raise ValueError("path too long")
+    return str(path)
+

dcc_mcp_openscreen/skills/openscreen/scripts/captions.py

@@ -0,0 +1,4 @@
+from dcc_mcp_core.skill import skill_entry, skill_success
+from ._client import run, path_arg
+@skill_entry
+def main(project, min_words=2, max_words=7, **_): return skill_success("OpenScreen captions generated.", **run(["captions", path_arg(project), "--min-words", str(min_words), "--max-words", str(max_words)], timeout=1800))

dcc_mcp_openscreen/skills/openscreen/scripts/export.py

@@ -0,0 +1,7 @@
+from dcc_mcp_core.skill import skill_entry, skill_success
+from ._client import run, path_arg
+@skill_entry
+def main(project, output=None, quality="source", **_):
+    args=["export",path_arg(project),"--quality",quality]
+    if output: args += ["--out",path_arg(output)]
+    return skill_success("OpenScreen export completed.", **run(args, timeout=1800))

dcc_mcp_openscreen/skills/openscreen/scripts/info.py

@@ -0,0 +1,4 @@
+from dcc_mcp_core.skill import skill_entry, skill_success
+from ._client import run, path_arg
+@skill_entry
+def main(project, **_): return skill_success("OpenScreen project inspected.", **run(["info", path_arg(project)]))

dcc_mcp_openscreen/skills/openscreen/scripts/pack.py

@@ -0,0 +1,4 @@
+from dcc_mcp_core.skill import skill_entry, skill_success
+from ._client import run, path_arg
+@skill_entry
+def main(project, output, **_): return skill_success("OpenScreen project packed.", **run(["pack", path_arg(project), "--out", path_arg(output)], timeout=600))

dcc_mcp_openscreen/skills/openscreen/scripts/record.py

@@ -0,0 +1,11 @@
+from dcc_mcp_core.skill import skill_entry, skill_success
+from ._client import record, path_arg
+@skill_entry
+def main(duration=30, window=None, display=0, project=None, mic=False, system_audio=False, **_):
+    if not isinstance(duration,int) or duration<1 or duration>3600: raise ValueError("duration must be 1..3600 seconds")
+    args=["--display",str(display)]
+    if window: args += ["--window",str(window)]
+    if project: args += ["--project",path_arg(project)]
+    if mic: args += ["--mic"]
+    if system_audio: args += ["--system-audio"]
+    return skill_success("OpenScreen recording completed.", **record(args,duration=duration,timeout=duration+120))

dcc_mcp_openscreen/skills/openscreen/scripts/sources.py

@@ -0,0 +1,4 @@
+from dcc_mcp_core.skill import skill_entry, skill_success
+from ._client import run
+@skill_entry
+def main(**_): return skill_success("OpenScreen sources enumerated.", **run(["sources"]))

dcc_mcp_openscreen/skills/openscreen/tools.yaml

@@ -0,0 +1,67 @@
+skill: openscreen
+version: "0.1.0"
+description: Record and export OpenScreen projects through its typed headless CLI.
+tools:
+  - name: sources
+    description: List available displays, windows, and microphones.
+    source_file: scripts/sources.py
+    input_schema: {type: object, additionalProperties: false}
+    execution: sync
+    affinity: any
+    annotations: {read_only_hint: true, destructive_hint: false, idempotent_hint: true, open_world_hint: false}
+  - name: record
+    description: Record a bounded display or window capture to an optional OpenScreen project.
+    source_file: scripts/record.py
+    input_schema:
+      type: object
+      additionalProperties: false
+      properties:
+        duration: {type: integer, minimum: 1, maximum: 3600, default: 30}
+        window: {type: string, minLength: 1, maxLength: 256}
+        display: {type: integer, minimum: 0, maximum: 32, default: 0}
+        project: {type: string, maxLength: 4096}
+        mic: {type: boolean, default: false}
+        system_audio: {type: boolean, default: false}
+    execution: sync
+    affinity: any
+    timeout_hint_secs: 3720
+    annotations: {read_only_hint: false, destructive_hint: true, idempotent_hint: false, open_world_hint: false}
+  - name: export
+    description: Render an OpenScreen project to MP4 or GIF.
+    source_file: scripts/export.py
+    input_schema:
+      type: object
+      required: [project]
+      additionalProperties: false
+      properties:
+        project: {type: string, minLength: 1, maxLength: 4096}
+        output: {type: string, maxLength: 4096}
+        quality: {enum: [medium, good, source], default: source}
+    execution: sync
+    affinity: any
+    timeout_hint_secs: 1800
+    annotations: {read_only_hint: false, destructive_hint: true, idempotent_hint: true, open_world_hint: false}
+  - name: info
+    description: Inspect a project and verify referenced media.
+    source_file: scripts/info.py
+    input_schema: {type: object, required: [project], additionalProperties: false, properties: {project: {type: string, minLength: 1, maxLength: 4096}}}
+    execution: sync
+    affinity: any
+    timeout_hint_secs: 60
+    annotations: {read_only_hint: true, destructive_hint: false, idempotent_hint: true, open_world_hint: false}
+  - name: pack
+    description: Pack a project and referenced media into a portable folder.
+    source_file: scripts/pack.py
+    input_schema: {type: object, required: [project, output], additionalProperties: false, properties: {project: {type: string, minLength: 1, maxLength: 4096}, output: {type: string, minLength: 1, maxLength: 4096}}}
+    execution: sync
+    affinity: any
+    timeout_hint_secs: 600
+    annotations: {read_only_hint: false, destructive_hint: true, idempotent_hint: true, open_world_hint: false}
+  - name: captions
+    description: Generate local Whisper captions for a project with bounded word grouping.
+    source_file: scripts/captions.py
+    input_schema: {type: object, required: [project], additionalProperties: false, properties: {project: {type: string, minLength: 1, maxLength: 4096}, min_words: {type: integer, minimum: 1, maximum: 20, default: 2}, max_words: {type: integer, minimum: 1, maximum: 20, default: 7}}}
+    execution: sync
+    affinity: any
+    timeout_hint_secs: 1800
+    annotations: {read_only_hint: false, destructive_hint: true, idempotent_hint: true, open_world_hint: false}

dcc_mcp_openscreen-0.1.1.dist-info/METADATA

@@ -0,0 +1,28 @@
+Metadata-Version: 2.4
+Name: dcc-mcp-openscreen
+Version: 0.1.1
+Summary: OpenScreen recording and demo export adapter for DCC-MCP
+Author-email: Long Hao <hal.long@outlook.com>
+License: MIT
+Requires-Python: >=3.7
+Requires-Dist: dcc-mcp-core<1.0.0,>=0.20.14
+Description-Content-Type: text/markdown
+
+# dcc-mcp-openscreen
+
+Standalone DCC-MCP adapter for [OpenScreen](https://github.com/getopenscreen/openscreen).
+
+The adapter exposes only typed, bounded CLI operations. Set `DCC_MCP_OPENSCREEN_PATH` when the executable is not on `PATH`. It does not automate the desktop UI; DCC window selection and unsupported UI actions remain owned by `dcc-cua` / `ui-control`.
+
+## Run
+
+```powershell
+python -m pip install -e .
+dcc-mcp-openscreen
+```
+
+Tools: `openscreen__sources`, `openscreen__record`, and `openscreen__export`.
+
+## License
+
+MIT

dcc_mcp_openscreen-0.1.1.dist-info/RECORD

@@ -0,0 +1,14 @@
+dcc_mcp_openscreen/__init__.py,sha256=GzgC6No-VRRRJbserj4W6nBdeaOYmTLHcxc0_1JnpG4,74
+dcc_mcp_openscreen/server.py,sha256=_qZDFbrnm6JSlYFzdztm-BWt5TDRLx8ChB1mLla5M0M,1069
+dcc_mcp_openscreen/skills/openscreen/tools.yaml,sha256=hd4_xBiU7f9D-kRJJURXaNF6HxXBhD59BChbeRsXROI,3376
+dcc_mcp_openscreen/skills/openscreen/scripts/_client.py,sha256=1h2YjFIZNI0SPnq9T4270ESf8Bw2F_595HqMplNS4EU,2274
+dcc_mcp_openscreen/skills/openscreen/scripts/captions.py,sha256=M8OsrwnadUD17IbMaw7KaFuR4szqhIMRdjiqCkahpBk,327
+dcc_mcp_openscreen/skills/openscreen/scripts/export.py,sha256=SWltsgjgCtmeG0nnqTsKwtxHzb592XYm4ygIoUfqoKM,353
+dcc_mcp_openscreen/skills/openscreen/scripts/info.py,sha256=3dDv4vnLmR6UZGoJAt8l-9Ua3_qaABOu_SflBh9rlH8,220
+dcc_mcp_openscreen/skills/openscreen/scripts/pack.py,sha256=ddKtAs_uqHKYc3R_WqRyQjwt8g9p4gA-Y0jwrhYI6oo,265
+dcc_mcp_openscreen/skills/openscreen/scripts/record.py,sha256=lACbFOb99jyczSr-vqjhBdnnV6ANB_SSCVnqfslyEQI,660
+dcc_mcp_openscreen/skills/openscreen/scripts/sources.py,sha256=OqSKegAN-_6suUWLXK5tCmoBQ1ZARWho9PdrY7qibjY,186
+dcc_mcp_openscreen-0.1.1.dist-info/METADATA,sha256=GdmyiFCWPL7YkeyczHWEnEvWHdnaymIjThxmN-rjzQA,828
+dcc_mcp_openscreen-0.1.1.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+dcc_mcp_openscreen-0.1.1.dist-info/entry_points.txt,sha256=nx5HVrUKcDOko0CvJ42TKG2noBMLXemRK7FJJQ4yT6I,142
+dcc_mcp_openscreen-0.1.1.dist-info/RECORD,,

dcc_mcp_openscreen-0.1.1.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.29.0
+Root-Is-Purelib: true
+Tag: py3-none-any

dcc_mcp_openscreen-0.1.1.dist-info/entry_points.txt

@@ -0,0 +1,5 @@
+[console_scripts]
+dcc-mcp-openscreen = dcc_mcp_openscreen.server:main
+
+[dcc_mcp.adapters]
+openscreen = dcc_mcp_openscreen:OpenScreenMcpServer