obsbot-mcp 0.1.0

package/dist/transport/helper-process.d.ts

@@ -0,0 +1,39 @@
+import { DeviceInfo } from "../codec/types.js";
+import { Snapshot, SnapshotOpts } from "./transport.js";
+export declare class HelperProcess {
+    private commandOverride?;
+    private proc?;
+    private rl?;
+    private queue;
+    constructor(commandOverride?: string[] | undefined);
+    static resolveBinaryPath(platform?: string, arch?: string): string;
+    start(): Promise<void>;
+    private rpcRaw;
+    private rpc;
+    version(): Promise<string>;
+    enumerate(): Promise<DeviceInfo[]>;
+    open(path: string): Promise<number>;
+    xuSet(selector: number, data: Buffer): Promise<void>;
+    xuGet(selector: number, length: number): Promise<Buffer>;
+    zoomRange(): Promise<{
+        min: number;
+        max: number;
+    }>;
+    zoomSet(units: number): Promise<void>;
+    snapshot(opts: SnapshotOpts): Promise<Snapshot>;
+    camCtrlSet(property: number, value: number, flags: number): Promise<void>;
+    camCtrlRange(property: number): Promise<{
+        min: number;
+        max: number;
+    }>;
+    camCtrlGet(property: number): Promise<{
+        value: number;
+        flags: number;
+    }>;
+    procAmpSet(property: number, value: number, flags: number): Promise<void>;
+    procAmpRange(property: number): Promise<{
+        min: number;
+        max: number;
+    }>;
+    close(): Promise<void>;
+}

package/dist/transport/helper-process.js

@@ -0,0 +1,140 @@
+import { spawn } from "node:child_process";
+import { createInterface } from "node:readline";
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
+import { CameraBusyError } from "./transport.js";
+const SUPPORTED = { win32: "obsbot-helper.exe" };
+export class HelperProcess {
+    commandOverride;
+    proc;
+    rl;
+    queue = [];
+    constructor(commandOverride) {
+        this.commandOverride = commandOverride;
+    }
+    static resolveBinaryPath(platform = process.platform, arch = process.arch) {
+        const bin = SUPPORTED[platform];
+        if (!bin) {
+            throw new Error(`transport not yet implemented for ${platform}`);
+        }
+        const root = join(dirname(fileURLToPath(import.meta.url)), "..", "..");
+        return join(root, "native", "prebuilt", `${platform}-${arch}`, bin);
+    }
+    async start() {
+        const [cmd, ...args] = this.commandOverride ?? [
+            HelperProcess.resolveBinaryPath(),
+        ];
+        this.proc = spawn(cmd, args, { stdio: ["pipe", "pipe", "inherit"] });
+        this.rl = createInterface({ input: this.proc.stdout });
+        this.rl.on("line", (line) => {
+            if (!line.trim())
+                return;
+            let parsed;
+            try {
+                parsed = JSON.parse(line);
+            }
+            catch {
+                // Not JSON at all — likely a stray log/diagnostic line the helper
+                // wrote to stdout. Ignore it without shifting the queue so it
+                // can't desync request/response correlation.
+                return;
+            }
+            if (typeof parsed !== "object" ||
+                parsed === null ||
+                typeof parsed.ok !== "boolean") {
+                // Valid JSON but not a recognizable RPC response (missing/invalid
+                // `ok` field). Treat as noise rather than desyncing the queue.
+                return;
+            }
+            const cb = this.queue.shift();
+            if (cb)
+                cb(parsed);
+        });
+    }
+    // Send a request and resolve with the raw response, whatever `ok` is.
+    rpcRaw(req) {
+        return new Promise((resolve) => {
+            this.queue.push(resolve);
+            this.proc.stdin.write(JSON.stringify(req) + "\n");
+        });
+    }
+    async rpc(req) {
+        const resp = await this.rpcRaw(req);
+        if (!resp.ok)
+            throw new Error(resp.error ?? "helper error (no message)");
+        return resp;
+    }
+    async version() {
+        const resp = await this.rpc({ op: "version" });
+        return resp.version;
+    }
+    async enumerate() {
+        const resp = await this.rpc({ op: "enumerate" });
+        return resp.devices;
+    }
+    async open(path) {
+        const resp = await this.rpc({ op: "open", path });
+        return resp.xuNode;
+    }
+    async xuSet(selector, data) {
+        await this.rpc({ op: "xu_set", selector, hex: data.toString("hex") });
+    }
+    async xuGet(selector, length) {
+        const resp = await this.rpc({ op: "xu_get", selector, length });
+        return Buffer.from(resp.hex, "hex");
+    }
+    async zoomRange() {
+        const resp = await this.rpc({ op: "zoom_range" });
+        return { min: resp.min, max: resp.max };
+    }
+    async zoomSet(units) {
+        await this.rpc({ op: "zoom_set", units });
+    }
+    async snapshot(opts) {
+        const req = { op: "snapshot" };
+        if (opts.path !== undefined)
+            req.path = opts.path;
+        if (opts.maxDim !== undefined)
+            req.maxDim = opts.maxDim;
+        if (opts.quality !== undefined)
+            req.quality = opts.quality;
+        if (opts.settleMs !== undefined)
+            req.settleMs = opts.settleMs;
+        const resp = await this.rpcRaw(req);
+        if (!resp.ok) {
+            if (resp.busy)
+                throw new CameraBusyError(resp.error ?? undefined);
+            throw new Error(resp.error ?? "snapshot failed");
+        }
+        return {
+            mime: resp.mime,
+            width: resp.width,
+            height: resp.height,
+            base64: resp.base64,
+        };
+    }
+    async camCtrlSet(property, value, flags) {
+        await this.rpc({ op: "camctrl_set", property, value, flags });
+    }
+    async camCtrlRange(property) {
+        const resp = await this.rpc({ op: "camctrl_range", property });
+        return { min: resp.min, max: resp.max };
+    }
+    async camCtrlGet(property) {
+        const resp = await this.rpc({ op: "camctrl_get", property });
+        return { value: resp.value, flags: resp.flags };
+    }
+    async procAmpSet(property, value, flags) {
+        await this.rpc({ op: "procamp_set", property, value, flags });
+    }
+    async procAmpRange(property) {
+        const resp = await this.rpc({ op: "procamp_range", property });
+        return { min: resp.min, max: resp.max };
+    }
+    async close() {
+        this.rl?.close();
+        this.proc?.stdin.end();
+        this.proc?.kill();
+    }
+}
+//# sourceMappingURL=helper-process.js.map

package/dist/transport/helper-process.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helper-process.js","sourceRoot":"","sources":["../../src/transport/helper-process.ts"],"names":[],"mappings":"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"}

package/dist/transport/transport.d.ts

@@ -0,0 +1,62 @@
+export interface Snapshot {
+    mime: string;
+    width: number;
+    height: number;
+    base64: string;
+}
+export interface SnapshotOpts {
+    path?: string;
+    maxDim?: number;
+    quality?: number;
+    settleMs?: number;
+}
+/** Thrown when a snapshot fails because another app holds the capture pin. */
+export declare class CameraBusyError extends Error {
+    constructor(message?: string);
+}
+export interface ObsbotTransport {
+    sendVendor(frame: Buffer): Promise<void>;
+    /**
+     * Send a vendor request frame (SET_CUR on the vendor selector) and read the
+     * reply frame back (GET_CUR on the response selector). Returns the raw reply
+     * bytes; callers parse with parseFrame.
+     */
+    recvVendor(frame: Buffer, length?: number): Promise<Buffer>;
+    /**
+     * Read the camera's flat status block via GET_CUR on the status selector
+     * (no request frame is sent). Returns the raw block; callers use decodeStatus.
+     */
+    recvStatus(length?: number): Promise<Buffer>;
+    /** Send a raw payload to an arbitrary UVC extension-unit selector (e.g. FOV/HDR on selector 6). */
+    xuRaw(selector: number, data: Buffer): Promise<void>;
+    /** RE/diagnostics: GET_CUR read `length` bytes from an arbitrary XU selector (no request frame sent). */
+    xuGetRaw(selector: number, length: number): Promise<Buffer>;
+    zoomRange(): Promise<{
+        min: number;
+        max: number;
+    }>;
+    zoomSet(units: number): Promise<void>;
+    /** Grab one still frame (grab-and-release). Throws CameraBusyError if the pin is busy. */
+    snapshot(opts: SnapshotOpts): Promise<Snapshot>;
+    /** IAMCameraControl::Set(property, value, flags) — used for focus. */
+    camCtrlSet(property: number, value: number, flags: number): Promise<void>;
+    /** IAMCameraControl::GetRange(property) → device-unit min/max. */
+    camCtrlRange(property: number): Promise<{
+        min: number;
+        max: number;
+    }>;
+    /** Read the current value + flags of an IAMCameraControl property (GET_CUR). */
+    camCtrlGet(property: number): Promise<{
+        value: number;
+        flags: number;
+    }>;
+    /** IAMVideoProcAmp::Set(property, value, flags) — used for white balance. */
+    procAmpSet(property: number, value: number, flags: number): Promise<void>;
+    /** IAMVideoProcAmp::GetRange(property) → device-unit min/max. */
+    procAmpRange(property: number): Promise<{
+        min: number;
+        max: number;
+    }>;
+    nextSeq(): number;
+    close(): Promise<void>;
+}

package/dist/transport/transport.js

@@ -0,0 +1,8 @@
+/** Thrown when a snapshot fails because another app holds the capture pin. */
+export class CameraBusyError extends Error {
+    constructor(message = "camera in use by another application") {
+        super(message);
+        this.name = "CameraBusyError";
+    }
+}
+//# sourceMappingURL=transport.js.map

package/dist/transport/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../../src/transport/transport.ts"],"names":[],"mappings":"AAcA,8EAA8E;AAC9E,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACxC,YAAY,OAAO,GAAG,sCAAsC;QAC1D,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF"}

package/dist/transport/windows.d.ts

@@ -0,0 +1,34 @@
+import { HelperProcess } from "./helper-process.js";
+import { ObsbotTransport, Snapshot, SnapshotOpts } from "./transport.js";
+export declare class WindowsTransport implements ObsbotTransport {
+    private helper;
+    private seq;
+    constructor(helper: HelperProcess);
+    sendVendor(frame: Buffer): Promise<void>;
+    recvVendor(frame: Buffer, length?: number): Promise<Buffer>;
+    recvStatus(length?: number): Promise<Buffer>;
+    xuRaw(selector: number, data: Buffer): Promise<void>;
+    xuGetRaw(selector: number, length: number): Promise<Buffer>;
+    zoomRange(): Promise<{
+        min: number;
+        max: number;
+    }>;
+    zoomSet(units: number): Promise<void>;
+    snapshot(opts: SnapshotOpts): Promise<Snapshot>;
+    camCtrlSet(property: number, value: number, flags: number): Promise<void>;
+    camCtrlRange(property: number): Promise<{
+        min: number;
+        max: number;
+    }>;
+    camCtrlGet(property: number): Promise<{
+        value: number;
+        flags: number;
+    }>;
+    procAmpSet(property: number, value: number, flags: number): Promise<void>;
+    procAmpRange(property: number): Promise<{
+        min: number;
+        max: number;
+    }>;
+    nextSeq(): number;
+    close(): Promise<void>;
+}

package/dist/transport/windows.js

@@ -0,0 +1,68 @@
+const VENDOR_XU_SELECTOR = 0x02;
+// Intended read-back selector for the (future) per-command V3-frame Get path
+// used by recvVendor. NOT YET verified on hardware — the per-command reply path
+// is unproven scaffolding; Slice 1 shipped the status-block read instead. A
+// separate constant from VENDOR_XU_SELECTOR because it may need to diverge once
+// that path is validated. Change here only.
+const RESPONSE_SELECTOR = 0x02;
+const DEFAULT_REPLY_LEN = 60;
+// The camera exposes a flat status block on this XU selector; GET_CUR reads it
+// whole (see decodeStatus). Confirmed on the physical Tiny 2 (2026-07-13):
+// awake (byte 0x02) and hdr (byte 0x06) round-trip against set_run_status/hdr.
+const STATUS_SELECTOR = 0x06;
+const STATUS_BLOCK_LEN = 60;
+export class WindowsTransport {
+    helper;
+    seq = 0;
+    constructor(helper) {
+        this.helper = helper;
+    }
+    async sendVendor(frame) {
+        await this.helper.xuSet(VENDOR_XU_SELECTOR, frame);
+    }
+    async recvVendor(frame, length = DEFAULT_REPLY_LEN) {
+        await this.helper.xuSet(VENDOR_XU_SELECTOR, frame);
+        return this.helper.xuGet(RESPONSE_SELECTOR, length);
+    }
+    async recvStatus(length = STATUS_BLOCK_LEN) {
+        return this.helper.xuGet(STATUS_SELECTOR, length);
+    }
+    async xuRaw(selector, data) {
+        await this.helper.xuSet(selector, data);
+    }
+    async xuGetRaw(selector, length) {
+        return this.helper.xuGet(selector, length);
+    }
+    async zoomRange() {
+        return this.helper.zoomRange();
+    }
+    async zoomSet(units) {
+        await this.helper.zoomSet(units);
+    }
+    async snapshot(opts) {
+        return this.helper.snapshot(opts);
+    }
+    async camCtrlSet(property, value, flags) {
+        await this.helper.camCtrlSet(property, value, flags);
+    }
+    async camCtrlRange(property) {
+        return this.helper.camCtrlRange(property);
+    }
+    async camCtrlGet(property) {
+        return this.helper.camCtrlGet(property);
+    }
+    async procAmpSet(property, value, flags) {
+        await this.helper.procAmpSet(property, value, flags);
+    }
+    async procAmpRange(property) {
+        return this.helper.procAmpRange(property);
+    }
+    nextSeq() {
+        this.seq = this.seq >= 0xffff ? 1 : this.seq + 1;
+        return this.seq;
+    }
+    async close() {
+        await this.helper.close();
+    }
+}
+//# sourceMappingURL=windows.js.map

package/dist/transport/windows.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"windows.js","sourceRoot":"","sources":["../../src/transport/windows.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "obsbot-mcp",
+  "version": "0.1.0",
+  "description": "Cross-platform MCP server for OBSBOT Tiny 2 (UVC) camera control",
+  "license": "MIT",
+  "author": "Michael Jordan",
+  "repository": { "type": "git", "url": "git+https://github.com/lxman/obsbot-mcp.git" },
+  "homepage": "https://github.com/lxman/obsbot-mcp#readme",
+  "bugs": { "url": "https://github.com/lxman/obsbot-mcp/issues" },
+  "keywords": ["mcp", "model-context-protocol", "obsbot", "webcam", "uvc", "ptz", "camera"],
+  "type": "module",
+  "bin": { "obsbot-mcp": "dist/index.js" },
+  "files": ["dist/", "native/prebuilt/"],
+  "engines": { "node": ">=18" },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^3.23.0",
+    "zod-to-json-schema": "^3.23.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.5.0",
+    "vitest": "^2.0.0",
+    "@types/node": "^20.0.0"
+  },
+  "allowScripts": {
+    "esbuild@0.21.5": true
+  }
+}