keyshot-mcp 0.5.0 → 0.6.0

package/README.md

@@ -32,6 +32,7 @@ This project does not include KeyShot, does not bypass licensing, and does not s
 - Import a model into a scene.
 - Apply a material to an object.
 - Create or update a camera.
+- Apply reusable standard or custom camera presets.
 - Set an environment when the installed KeyShot version exposes that function.
 - Save a scene to a new file.
 
@@ -68,7 +69,7 @@ This project does not include KeyShot, does not bypass licensing, and does not s
 npm install -g keyshot-mcp
 ```
 
-The current release line is `0.5.0`. The published package is the easiest option
+The current release line is `0.6.0`. The published package is the easiest option
 when you only want to use the MCP server. You still need KeyShot Studio and a
 local KeyShot license.
 
@@ -92,7 +93,7 @@ Use exactly one of these approaches:
 **No installation, run with npx**:
 
 ```json
-{"mcpServers":{"keyshot":{"command":"npx","args":["-y","keyshot-mcp@0.5.0"],"env":{"KEYSHOT_HEADLESS_EXE":"/absolute/path/to/keyshot_headless"}}}}
+{"mcpServers":{"keyshot":{"command":"npx","args":["-y","keyshot-mcp@0.6.0"],"env":{"KEYSHOT_HEADLESS_EXE":"/absolute/path/to/keyshot_headless"}}}}
 ```
 
 **Run from a cloned source directory** (after `npm install && npm run build`):
@@ -106,11 +107,11 @@ Use exactly one of these approaches:
 If you use Codex or another coding agent, you can copy this prompt and let the agent install the MCP server for you:
 
 ```text
-Install KeyShot MCP 0.5.0 from npm and configure it in my MCP client.
+Install KeyShot MCP 0.6.0 from npm and configure it in my MCP client.
 
 Please:
 1. Find my KeyShot headless executable path.
-2. Add a keyshot MCP server using npx -y keyshot-mcp@0.5.0.
+2. Add a keyshot MCP server using npx -y keyshot-mcp@0.6.0.
 3. Set KEYSHOT_HEADLESS_EXE to the detected keyshot_headless path.
 4. Test the setup by running the keyshot_status tool.
 5. Tell me the exact config that was added and whether the status check passed.
@@ -208,6 +209,11 @@ Find every camera in this KeyShot scene and render all views to the all-cameras
 output folder. Continue if one camera fails and report the result for each view.
 ```
 
+```text
+List the available camera presets, apply the Isometric preset as a camera named
+"Catalog Isometric", save a new scene, and render a preview from that camera.
+```
+
 ## Environment Variables
 
 - `KEYSHOT_HEADLESS_EXE`: path to `keyshot_headless` or `keyshot_headless.exe`.
@@ -215,6 +221,7 @@ output folder. Continue if one camera fails and report the result for each view.
 - `KEYSHOT_LICENSE_ARGS`: optional KeyShot headless license arguments. Empty by default.
 - `KEYSHOT_TIMEOUT_MS`: operation timeout in milliseconds. Default: `600000`.
 - `KEYSHOT_ALLOW_EXTERNAL_OUTPUTS`: allow output paths outside `KEYSHOT_OUTPUT_DIR`. Default: `false`.
+- `KEYSHOT_CAMERA_PRESETS`: camera preset JSON file. Default: `presets/cameras.json`.
 
 By default every output file must stay inside `KEYSHOT_OUTPUT_DIR`. Relative paths
 are placed there automatically. Set the compatibility switch to `true` only when
@@ -237,6 +244,8 @@ or the other, not both.
 - `keyshot_list_material_presets`: list presets from the material preset library
 - `keyshot_apply_material_preset`: apply a named preset from the library to an object
 - `keyshot_set_camera`
+- `keyshot_list_camera_presets`: list standard and custom camera presets
+- `keyshot_apply_camera_preset`: create or update a named camera from a preset
 - `keyshot_set_environment`
 - `keyshot_save_scene`
 
@@ -265,6 +274,30 @@ looks instead of remembering exact KeyShot material names. Default location:
 Each preset must have a `materialName` or a `materialPath`. Use
 `keyshot_list_material_presets` to see what is available.
 
+### Camera preset library
+
+The built-in `presets/cameras.json` provides Front, Back, Left, Right, Top,
+Bottom, and Isometric standard views. Use `keyshot_list_camera_presets` to list
+them and `keyshot_apply_camera_preset` to create or update a named camera.
+
+Set `KEYSHOT_CAMERA_PRESETS` to a user-managed JSON file for custom presets:
+
+```json
+{
+  "Front": { "standardView": "front" },
+  "Hero": {
+    "position": [4.5, 3.5, 4.5],
+    "lookAt": [0, 0, 0],
+    "up": [0, 1, 0],
+    "description": "Custom absolute product camera"
+  }
+}
+```
+
+A preset file may use the object format shown above or an array whose entries
+include a `name`. Each preset must contain either one supported `standardView`,
+or both `position` and `lookAt`. Preset files are read-only to this MCP server.
+
 ## MCP Prompts and Resources
 
 - Prompt: `keyshot_product_render`
@@ -287,7 +320,7 @@ KeyShot's Python `lux` API changes across versions. This server keeps the MCP in
 
 - [x] Auto-discover and batch render all cameras in a scene
 - [x] Material preset library
-- [ ] Camera preset templates
+- [x] Camera preset templates
 - [x] Sequential render queue
 - [x] Safer output directory restrictions
 - [ ] More tested KeyShot versions
@@ -341,6 +374,7 @@ MIT
 - 把模型导入场景。
 - 给对象替换材质。
 - 创建或更新相机。
+- 应用可复用的标准或自定义相机预设。
 - 在当前 KeyShot 版本支持时设置环境。
 - 把场景保存为新文件。
 
@@ -377,7 +411,7 @@ MIT
 npm install -g keyshot-mcp
 ```
 
-当前发布版本为 `0.5.0`。如果你只是想使用 MCP 服务，直接安装 npm 包最简单。
+当前发布版本为 `0.6.0`。如果你只是想使用 MCP 服务，直接安装 npm 包最简单。
 电脑仍需要安装 KeyShot Studio，并且已经配置好本地 KeyShot 授权。
 
 ### 从源码安装
@@ -400,7 +434,7 @@ npm run build
 **免安装，直接使用 npx**：
 
 ```json
-{"mcpServers":{"keyshot":{"command":"npx","args":["-y","keyshot-mcp@0.5.0"],"env":{"KEYSHOT_HEADLESS_EXE":"C:/KeyShot/bin/keyshot_headless.exe"}}}}
+{"mcpServers":{"keyshot":{"command":"npx","args":["-y","keyshot-mcp@0.6.0"],"env":{"KEYSHOT_HEADLESS_EXE":"C:/KeyShot/bin/keyshot_headless.exe"}}}}
 ```
 
 **使用本地源码**（先运行 `npm install && npm run build`）：
@@ -414,11 +448,11 @@ npm run build
 如果你使用 Codex 或其他编程 Agent，可以复制下面这段话，让 Agent 帮你安装和配置 MCP：
 
 ```text
-请帮我安装 KeyShot MCP 0.5.0，并添加到我的 MCP 客户端。
+请帮我安装 KeyShot MCP 0.6.0，并添加到我的 MCP 客户端。
 
 请你：
 1. 查找我电脑上的 KeyShot headless 可执行文件路径。
-2. 使用 npx -y keyshot-mcp@0.5.0 添加 keyshot MCP server。
+2. 使用 npx -y keyshot-mcp@0.6.0 添加 keyshot MCP server。
 3. 把 KEYSHOT_HEADLESS_EXE 设置为检测到的 keyshot_headless 路径。
 4. 用 keyshot_status 工具测试是否配置成功。
 5. 最后告诉我实际添加的配置，以及状态检查是否通过。
@@ -516,6 +550,11 @@ examples/codex.example.json
 某个相机失败时继续处理其他相机，最后告诉我每个视角的结果。
 ```
 
+```text
+列出可用的相机预设，把 Isometric 等距预设应用为名为“目录等距视图”的相机，
+保存一份新场景，并用这个相机渲染预览图。
+```
+
 ## 环境变量
 
 - `KEYSHOT_HEADLESS_EXE`：`keyshot_headless` 或 `keyshot_headless.exe` 的路径。
@@ -524,6 +563,7 @@ examples/codex.example.json
 - `KEYSHOT_TIMEOUT_MS`：单次操作超时时间，单位毫秒，默认 `600000`。
 - `KEYSHOT_MATERIAL_PRESETS`：材质预设库 JSON 文件路径，默认 `presets/materials.json`。
 - `KEYSHOT_ALLOW_EXTERNAL_OUTPUTS`：是否允许写到默认输出目录之外，默认 `false`。
+- `KEYSHOT_CAMERA_PRESETS`：相机预设 JSON 文件路径，默认 `presets/cameras.json`。
 
 默认情况下，所有输出图片和场景都必须写入 `KEYSHOT_OUTPUT_DIR`，相对路径会自动放入该目录。
 只有确实需要写到外部目录时才设置为 `true`；输入场景和模型路径不受此限制。
@@ -544,6 +584,8 @@ examples/codex.example.json
 - `keyshot_list_material_presets`：列出材质预设库中的预设。
 - `keyshot_apply_material_preset`：把预设库中的某个命名材质应用到物体上。
 - `keyshot_set_camera`：设置相机。
+- `keyshot_list_camera_presets`：列出标准和自定义相机预设。
+- `keyshot_apply_camera_preset`：用预设创建或更新命名相机。
 - `keyshot_set_environment`：设置环境。
 - `keyshot_save_scene`：保存场景。
 
@@ -569,6 +611,30 @@ examples/codex.example.json
 
 每个预设必须包含 `materialName` 或 `materialPath`。用 `keyshot_list_material_presets` 查看有哪些预设。
 
+### 相机预设库
+
+内置的 `presets/cameras.json` 包含 Front、Back、Left、Right、Top、Bottom 和
+Isometric 七个 KeyShot 标准视角。使用 `keyshot_list_camera_presets` 查看预设，
+使用 `keyshot_apply_camera_preset` 创建或更新命名相机。
+
+把 `KEYSHOT_CAMERA_PRESETS` 指向用户自己的 JSON 文件即可添加自定义预设：
+
+```json
+{
+  "正视图": { "standardView": "front" },
+  "产品主视角": {
+    "position": [4.5, 3.5, 4.5],
+    "lookAt": [0, 0, 0],
+    "up": [0, 1, 0],
+    "description": "自定义绝对坐标相机"
+  }
+}
+```
+
+预设文件既可以使用上面的对象格式，也可以使用每项包含 `name` 的数组格式。
+每个预设只能选择一种形式：填写一个受支持的 `standardView`，或者同时填写
+`position` 与 `lookAt`。MCP 只读取预设文件，不会自动修改它。
+
 ## MCP 提示词和资源
 
 - 提示词：`keyshot_product_render`
@@ -591,7 +657,7 @@ KeyShot 的 Python `lux` API 会随版本变化。这个 MCP 会尽量保持对
 
 - [x] 自动发现并批量渲染场景中的所有相机
 - [x] 材质预设库
-- [ ] 相机预设模板
+- [x] 相机预设模板
 - [x] 顺序渲染队列
 - [x] 更安全的输出目录限制
 - [ ] 测试更多 KeyShot 版本

package/dist/camera-presets.js

@@ -0,0 +1,86 @@
+import fs from "node:fs/promises";
+export const STANDARD_CAMERA_VIEWS = [
+    "front",
+    "back",
+    "left",
+    "right",
+    "top",
+    "bottom",
+    "isometric",
+];
+export async function loadCameraPresets(config) {
+    let raw;
+    try {
+        raw = await fs.readFile(config.cameraPresetsPath, "utf8");
+    }
+    catch {
+        return [];
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        throw new Error(`Camera presets file is not valid JSON: ${config.cameraPresetsPath}`);
+    }
+    return normalizeCameraPresets(parsed);
+}
+export function normalizeCameraPresets(parsed) {
+    const entries = [];
+    if (Array.isArray(parsed)) {
+        for (const item of parsed) {
+            if (!item || typeof item !== "object")
+                continue;
+            const record = item;
+            if (typeof record.name !== "string" || !record.name)
+                continue;
+            const preset = toCameraPreset(record.name, record);
+            if (preset)
+                entries.push(preset);
+        }
+    }
+    else if (parsed && typeof parsed === "object") {
+        for (const [name, value] of Object.entries(parsed)) {
+            if (!value || typeof value !== "object")
+                continue;
+            const preset = toCameraPreset(name, value);
+            if (preset)
+                entries.push(preset);
+        }
+    }
+    return entries;
+}
+export function findCameraPreset(presets, name) {
+    const lower = name.toLowerCase();
+    return (presets.find((preset) => preset.name === name) ??
+        presets.find((preset) => preset.name.toLowerCase() === lower));
+}
+function toCameraPreset(name, record) {
+    const description = typeof record.description === "string" ? record.description : undefined;
+    const standardView = normalizeStandardView(record.standardView);
+    const position = toVector(record.position);
+    const lookAt = toVector(record.lookAt);
+    const up = toVector(record.up);
+    const hasStandard = standardView !== undefined;
+    const hasAbsolute = position !== undefined || lookAt !== undefined || up !== undefined;
+    if (hasStandard && !hasAbsolute) {
+        return { name, type: "standard", standardView, description };
+    }
+    if (!hasStandard && position && lookAt) {
+        return { name, type: "absolute", position, lookAt, up, description };
+    }
+    return undefined;
+}
+function normalizeStandardView(value) {
+    if (typeof value !== "string")
+        return undefined;
+    const normalized = value.toLowerCase();
+    return STANDARD_CAMERA_VIEWS.find((view) => view === normalized);
+}
+function toVector(value) {
+    if (!Array.isArray(value) || value.length !== 3)
+        return undefined;
+    if (!value.every((item) => typeof item === "number" && Number.isFinite(item)))
+        return undefined;
+    return [value[0], value[1], value[2]];
+}

package/dist/config.js

@@ -15,6 +15,7 @@ export function getConfig() {
         tmpDir: path.join(projectRoot, "work", "tmp"),
         bridgeScriptPath: path.join(projectRoot, "scripts", "keyshot_bridge.py"),
         materialPresetsPath: path.resolve(process.env.KEYSHOT_MATERIAL_PRESETS ?? path.join(projectRoot, "presets", "materials.json")),
+        cameraPresetsPath: path.resolve(process.env.KEYSHOT_CAMERA_PRESETS ?? path.join(projectRoot, "presets", "cameras.json")),
     };
 }
 function parseBoolean(value) {

package/dist/index.js

@@ -6,8 +6,9 @@ import { toolResponse, localFailure } from "./result.js";
 import { runKeyShotSerialized } from "./runner.js";
 import { runRenderQueue } from "./queue.js";
 import { loadMaterialPresets, findMaterialPreset } from "./presets.js";
+import { loadCameraPresets, findCameraPreset } from "./camera-presets.js";
 import { VERSION } from "./version.js";
-import { applyMaterialSchema, applyMaterialInputSchema, applyMaterialPresetInputSchema, applyMaterialPresetSchema, batchRenderSchema, batchRenderInputSchema, importModelSchema, listCamerasSchema, listMaterialPresetsSchema, renderQueueSchema, renderQueueInputSchema, renderAllCamerasSchema, renderAllCamerasInputSchema, renderSchema, renderInputSchema, saveSceneSchema, scenePathSchema, setCameraSchema, setEnvironmentSchema, } from "./schemas.js";
+import { applyMaterialSchema, applyMaterialInputSchema, applyMaterialPresetInputSchema, applyMaterialPresetSchema, applyCameraPresetSchema, batchRenderSchema, batchRenderInputSchema, importModelSchema, listCamerasSchema, listMaterialPresetsSchema, listCameraPresetsSchema, renderQueueSchema, renderQueueInputSchema, renderAllCamerasSchema, renderAllCamerasInputSchema, renderSchema, renderInputSchema, saveSceneSchema, scenePathSchema, setCameraSchema, setEnvironmentSchema, } from "./schemas.js";
 const config = getConfig();
 const server = new McpServer({
     name: "keyshot-mcp",
@@ -125,6 +126,58 @@ server.tool("keyshot_apply_material_preset", "Apply a named material preset (fro
     }));
 });
 server.tool("keyshot_set_camera", "Create or update a camera from position/look-at vectors and save the resulting scene.", setCameraSchema.shape, async (args) => toolResponse(await runKeyShotSerialized(config, { operation: "set_camera", ...args })));
+server.tool("keyshot_list_camera_presets", "List standard and custom camera presets from presets/cameras.json or KEYSHOT_CAMERA_PRESETS.", listCameraPresetsSchema.shape, async () => {
+    try {
+        const presets = await loadCameraPresets(config);
+        return toolResponse({
+            ok: true,
+            data: { presets, count: presets.length, source: config.cameraPresetsPath },
+            outputFiles: [],
+            warnings: presets.length === 0 ? ["No valid camera presets found."] : [],
+            keyshotStdoutTail: "",
+            error: null,
+        });
+    }
+    catch (error) {
+        return toolResponse(localFailure(errorMessage(error)));
+    }
+});
+server.tool("keyshot_apply_camera_preset", "Create or update a named camera from a standard or custom camera preset and save the scene.", applyCameraPresetSchema.shape, async (args) => {
+    let presets;
+    try {
+        presets = await loadCameraPresets(config);
+    }
+    catch (error) {
+        return toolResponse(localFailure(errorMessage(error)));
+    }
+    const preset = findCameraPreset(presets, args.presetName);
+    if (!preset) {
+        const available = presets.map((entry) => entry.name).join(", ") || "(none)";
+        return toolResponse(localFailure(`Camera preset not found: "${args.presetName}". Available: ${available}`));
+    }
+    const request = preset.type === "standard"
+        ? {
+            operation: "set_standard_camera",
+            scenePath: args.scenePath,
+            standardView: preset.standardView,
+            cameraName: args.cameraName ?? preset.name,
+            outputScenePath: args.outputScenePath,
+        }
+        : {
+            operation: "set_camera",
+            scenePath: args.scenePath,
+            cameraName: args.cameraName ?? preset.name,
+            position: preset.position,
+            lookAt: preset.lookAt,
+            up: preset.up,
+            outputScenePath: args.outputScenePath,
+        };
+    const result = await runKeyShotSerialized(config, request);
+    if (result.data && typeof result.data === "object") {
+        result.data = { presetName: preset.name, presetType: preset.type, ...result.data };
+    }
+    return toolResponse(result);
+});
 server.tool("keyshot_set_environment", "Set a scene environment by name or file when supported by KeyShot headless scripting.", setEnvironmentSchema.shape, async (args) => toolResponse(await runKeyShotSerialized(config, { operation: "set_environment", ...args })));
 server.tool("keyshot_save_scene", "Save a KeyShot scene to a new path.", saveSceneSchema.shape, async (args) => toolResponse(await runKeyShotSerialized(config, { operation: "save_scene", ...args })));
 const transport = new StdioServerTransport();

package/dist/schemas.js

@@ -79,6 +79,13 @@ export const setCameraSchema = z.object({
     distance: z.number().positive().optional(),
     outputScenePath: z.string().min(1),
 });
+export const listCameraPresetsSchema = z.object({});
+export const applyCameraPresetSchema = z.object({
+    scenePath: z.string().min(1),
+    presetName: z.string().min(1),
+    cameraName: z.string().min(1).optional(),
+    outputScenePath: z.string().min(1),
+});
 export const setEnvironmentSchema = z.object({
     scenePath: z.string().min(1),
     environmentName: z.string().min(1).optional(),

package/dist/version.js

@@ -1 +1 @@
-export const VERSION = "0.5.0";
+export const VERSION = "0.6.0";

package/examples/demo/README.md

@@ -4,7 +4,7 @@
 repository's MIT license. It contains no customer model or third-party asset.
 
 Run `npm run smoke:keyshot` after setting `KEYSHOT_HEADLESS_EXE`. The command
-checks KeyShot, imports the cube, saves and inspects the scene, creates two MCP
-cameras, automatically discovers them, and renders both views under
+checks KeyShot, imports the cube, saves and inspects the scene, applies the
+built-in Front and Isometric camera presets, automatically discovers them, and renders both views under
 `outputs/demo/all-cameras`. Generated `.bip` and PNG files remain under
 `outputs/` and are ignored by Git.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "keyshot-mcp",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "mcpName": "io.github.truman-t3/keyshot-mcp",
   "description": "Local and portable MCP server for KeyShot headless scripting.",
   "type": "module",

package/presets/cameras.json

@@ -0,0 +1,30 @@
+{
+  "Front": {
+    "standardView": "front",
+    "description": "Front standard view / 正视图"
+  },
+  "Back": {
+    "standardView": "back",
+    "description": "Back standard view / 后视图"
+  },
+  "Left": {
+    "standardView": "left",
+    "description": "Left standard view / 左视图"
+  },
+  "Right": {
+    "standardView": "right",
+    "description": "Right standard view / 右视图"
+  },
+  "Top": {
+    "standardView": "top",
+    "description": "Top standard view / 顶视图"
+  },
+  "Bottom": {
+    "standardView": "bottom",
+    "description": "Bottom standard view / 底视图"
+  },
+  "Isometric": {
+    "standardView": "isometric",
+    "description": "Isometric standard view / 等距视图"
+  }
+}

package/scripts/keyshot-smoke.mjs

@@ -2,6 +2,7 @@ import crypto from "node:crypto";
 import fs from "node:fs/promises";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
+import { findCameraPreset, loadCameraPresets } from "../dist/camera-presets.js";
 import { getConfig } from "../dist/config.js";
 import { runKeyShotSerialized } from "../dist/runner.js";
 
@@ -20,6 +21,21 @@ async function run(label, request) {
   return result;
 }
 
+async function applyStandardPreset(label, scenePath, presetName, outputScenePath) {
+  const presets = await loadCameraPresets(config);
+  const preset = findCameraPreset(presets, presetName);
+  if (!preset || preset.type !== "standard") {
+    throw new Error(`Standard camera preset not found: ${presetName}`);
+  }
+  return run(label, {
+    operation: "set_standard_camera",
+    scenePath,
+    cameraName: preset.name,
+    standardView: preset.standardView,
+    outputScenePath,
+  });
+}
+
 const status = await run("1/7 KeyShot status", { operation: "status" });
 const imported = await run("2/7 Import and save generated OBJ", {
   operation: "import_model",
@@ -38,29 +54,23 @@ if (!Array.isArray(objects) || objects.length === 0) {
   throw new Error("Imported scene did not contain any inspectable objects.");
 }
 
-const firstCameraResult = await run("4/7 Create first camera and save scene", {
-  operation: "set_camera",
-  scenePath: importedScene,
-  cameraName: "MCP Front",
-  position: [4.5, 3.5, 4.5],
-  lookAt: [0, 0, 0],
-  up: [0, 1, 0],
-  outputScenePath: "demo/keyshot-mcp-demo-camera-front.bip",
-});
+const firstCameraResult = await applyStandardPreset(
+  "4/7 Apply Front camera preset",
+  importedScene,
+  "Front",
+  "demo/keyshot-mcp-demo-preset-front.bip",
+);
 const firstCameraScene = firstCameraResult.outputFiles[0];
-if (!firstCameraScene) throw new Error("First camera operation did not return a saved scene path.");
+if (!firstCameraScene) throw new Error("Front preset did not return a saved scene path.");
 
-const secondCameraResult = await run("5/7 Create second camera and save scene", {
-  operation: "set_camera",
-  scenePath: firstCameraScene,
-  cameraName: "MCP Angle",
-  position: [6.0, 2.5, 3.0],
-  lookAt: [0, 0, 0],
-  up: [0, 1, 0],
-  outputScenePath: "demo/keyshot-mcp-demo-camera-all.bip",
-});
+const secondCameraResult = await applyStandardPreset(
+  "5/7 Apply Isometric camera preset",
+  firstCameraScene,
+  "Isometric",
+  "demo/keyshot-mcp-demo-presets.bip",
+);
 const cameraScene = secondCameraResult.outputFiles[0];
-if (!cameraScene) throw new Error("Second camera operation did not return a saved scene path.");
+if (!cameraScene) throw new Error("Isometric preset did not return a saved scene path.");
 
 const rendered = await run("6/7 Discover and render every camera", {
   operation: "render_all_cameras",
@@ -80,10 +90,10 @@ if (!renderData || renderData.failed !== 0 || renderData.succeeded < 2) {
 }
 
 const namedResults = renderData.results.filter(
-  (entry) => entry.camera === "MCP Front" || entry.camera === "MCP Angle",
+  (entry) => entry.camera === "Front" || entry.camera === "Isometric",
 );
 if (namedResults.length !== 2 || namedResults.some((entry) => !entry.ok)) {
-  throw new Error("The two MCP demo cameras were not both rendered successfully.");
+  throw new Error("The Front and Isometric preset cameras were not both rendered successfully.");
 }
 const hashes = await Promise.all(namedResults.map(async (entry) =>
   crypto.createHash("sha256").update(await fs.readFile(entry.outputPath)).digest("hex")
@@ -103,5 +113,5 @@ console.log(JSON.stringify({
   scenePath: cameraScene,
   cameraCount: renderData.total,
   renderedImages: rendered.outputFiles,
-  verifiedCameras: namedResults.map((entry) => entry.camera),
+  verifiedPresets: namedResults.map((entry) => entry.camera),
 }, null, 2));

package/scripts/keyshot_bridge.py

@@ -45,6 +45,8 @@ def main():
             data = apply_material(payload, output_files, warnings)
         elif operation == "set_camera":
             data = set_camera(payload, output_files, warnings)
+        elif operation == "set_standard_camera":
+            data = set_standard_camera(payload, output_files, warnings)
         elif operation == "set_environment":
             data = set_environment(payload, output_files, warnings)
         elif operation == "save_scene":
@@ -469,6 +471,54 @@ def set_camera(payload, output_files, warnings):
     }
 
 
+def set_standard_camera(payload, output_files, warnings):
+    output_scene_path = payload.get("outputScenePath")
+    camera_name = payload.get("cameraName") or "MCP Camera"
+    standard_view = str(payload.get("standardView") or "").lower()
+    view_constants = {
+        "front": "VIEW_FRONT",
+        "back": "VIEW_BACK",
+        "left": "VIEW_LEFT",
+        "right": "VIEW_RIGHT",
+        "top": "VIEW_TOP",
+        "bottom": "VIEW_BOTTOM",
+        "isometric": "VIEW_ISOMETRIC",
+    }
+
+    constant_name = view_constants.get(standard_view)
+    if constant_name is None:
+        raise RuntimeError("Unsupported standard camera view: %s" % standard_view)
+    if not hasattr(lux, "setStandardView"):
+        raise RuntimeError("KeyShot lux.setStandardView is not available.")
+    if not hasattr(lux, constant_name):
+        raise RuntimeError("KeyShot camera constant is not available: %s" % constant_name)
+
+    if camera_name in camera_names():
+        if not hasattr(lux, "setCamera"):
+            raise RuntimeError("KeyShot cannot activate the existing camera: %s" % camera_name)
+        call_non_false_variants("activate camera", lambda: lux.setCamera(camera_name))
+    else:
+        call_non_false_variants(
+            "create camera",
+            lambda: lux.newCamera(camera_name),
+            lambda: lux.createCamera(camera_name),
+        )
+
+    call_variants("set standard camera view", lambda: lux.setStandardView(getattr(lux, constant_name)))
+    call_variants(
+        "save standard camera",
+        lambda: lux.saveCamera(),
+        lambda: lux.saveCamera(camera_name),
+    )
+    save_to(output_scene_path)
+    output_files.append(output_scene_path)
+    return {
+        "cameraName": camera_name,
+        "standardView": standard_view,
+        "savedScene": output_scene_path,
+    }
+
+
 def set_environment(payload, output_files, warnings):
     output_scene_path = payload.get("outputScenePath")
     environment_name = payload.get("environmentName")
@@ -602,6 +652,19 @@ def call_variants(label, *callbacks):
     raise RuntimeError("%s is unsupported or failed: %s" % (label, " | ".join(errors)))
 
 
+def call_non_false_variants(label, *callbacks):
+    errors = []
+    for callback in callbacks:
+        try:
+            value = callback()
+            if value is not False:
+                return value
+            errors.append("returned false")
+        except Exception as exc:
+            errors.append(str(exc))
+    raise RuntimeError("%s is unsupported or failed: %s" % (label, " | ".join(errors)))
+
+
 def first_success(*callbacks, default=None):
     for callback in callbacks:
         try:

package/server.json

@@ -9,12 +9,12 @@
     "url": "https://github.com/truman-t3/keyshot-mcp",
     "source": "github"
   },
-  "version": "0.5.0",
+  "version": "0.6.0",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "keyshot-mcp",
-      "version": "0.5.0",
+      "version": "0.6.0",
       "transport": {
         "type": "stdio"
       },
@@ -24,6 +24,12 @@
           "description": "Absolute path to KeyShot headless, or a command available on PATH.",
           "isRequired": true,
           "isSecret": false
+        },
+        {
+          "name": "KEYSHOT_CAMERA_PRESETS",
+          "description": "Optional path to a user-managed camera preset JSON file.",
+          "isRequired": false,
+          "isSecret": false
         }
       ]
     }