keyshot-mcp 0.7.0 → 0.8.0

package/README.md

@@ -28,6 +28,7 @@ the local computer.
 - Apply materials directly or through a local material preset library.
 - Select environments, change brightness, and rotate the active environment.
 - Save edited scenes to a controlled output directory.
+- Prepare and render a product from a model or existing scene in one tool call.
 
 ### Requirements and compatibility
 
@@ -40,7 +41,7 @@ the local computer.
 
 ### Install
 
-The current release is `0.7.0`.
+The current release is `0.8.0`.
 
 #### Option 1: run with npx
 
@@ -51,7 +52,7 @@ This requires no global npm installation:
   "mcpServers": {
     "keyshot": {
       "command": "npx",
-      "args": ["-y", "keyshot-mcp@0.7.0"],
+      "args": ["-y", "keyshot-mcp@0.8.0"],
       "env": {
         "KEYSHOT_HEADLESS_EXE": "C:/Program Files/KeyShot Studio/bin/keyshot_headless.exe"
       }
@@ -63,7 +64,7 @@ This requires no global npm installation:
 #### Option 2: install globally
 
 ```bash
-npm install -g keyshot-mcp@0.7.0
+npm install -g keyshot-mcp@0.8.0
 ```
 
 ```json
@@ -112,14 +113,14 @@ The following prompt can be pasted into a coding agent that is allowed to edit
 the MCP client configuration:
 
 ```text
-Install KeyShot MCP 0.7.0 and configure it in my MCP client.
+Install KeyShot MCP 0.8.0 and configure it in my MCP client.
 
 1. Find the local KeyShot headless executable.
 2. Add an MCP server named "keyshot" that runs:
-   npx -y keyshot-mcp@0.7.0
+   npx -y keyshot-mcp@0.8.0
 3. Set KEYSHOT_HEADLESS_EXE to the executable path.
 4. Keep KEYSHOT_ALLOW_EXTERNAL_OUTPUTS disabled.
-5. Restart or reload the MCP client, then call keyshot_status.
+5. Restart or reload the MCP client, call keyshot_status, then use keyshot_product_render for a one-click product render.
 6. Do not upload or publish any KeyShot scenes, models, renders, or license data.
 ```
 
@@ -144,6 +145,7 @@ scene, model, material, and environment paths may be located elsewhere.
 | Tool | Purpose |
 | --- | --- |
 | `keyshot_status` | Verify that KeyShot headless can start and report its version. |
+| `keyshot_product_render` | Prepare, save, and render a model or existing scene in one headless process. |
 | `keyshot_inspect_scene` | Inspect objects, cameras, materials, model sets, and references. |
 | `keyshot_list_cameras` | List available camera names. |
 | `keyshot_render` | Render one image. |
@@ -160,9 +162,48 @@ scene, model, material, and environment paths may be located elsewhere.
 | `keyshot_set_environment` | Select or adjust an environment, brightness, or rotation. |
 | `keyshot_save_scene` | Save a scene to a new output path. |
 
-The server also exposes a `keyshot_product_render` MCP prompt and a
+The server exposes 17 tools, a `keyshot_product_render` MCP prompt, and a
 `keyshot://workflow` resource.
 
+### One-click product render
+
+In an MCP client, a designer can use a natural-language request:
+
+```text
+Turn C:\models\speaker.obj into a product render. Center it, place it on the
+ground, use the Isometric camera preset, save the KeyShot scene, and render a
+1600 x 1200 PNG with 128 samples.
+```
+
+The `keyshot_product_render` tool accepts either `modelPath` or `scenePath`. New
+models default to centered and grounded geometry with a `Product Hero`
+isometric camera. Existing scenes keep their current camera, materials, and
+environment unless explicit changes are requested.
+
+```json
+{
+  "modelPath": "C:/models/speaker.obj",
+  "outputScenePath": "speaker-product.bip",
+  "outputPath": "speaker-product.png",
+  "materialAssignments": [
+    { "objectName": "Body", "presetName": "Brushed Steel" }
+  ],
+  "cameraPresetName": "Isometric",
+  "focalLength": 55,
+  "brightness": 1.2,
+  "rotation": 45,
+  "width": 1600,
+  "height": 1200,
+  "samples": 128
+}
+```
+
+Use `renderMode: "allCameras"` with `outputDir` to render every named camera.
+Generated names are derived from the source filename when output paths are
+omitted. Existing files are protected by default; set `overwrite: true` only
+when replacement is intentional. Material assignments always require an
+explicit object and never overwrite the entire model implicitly.
+
 ### Product composition examples
 
 Import a model and prepare its initial composition:
@@ -222,7 +263,8 @@ them.
 The repository includes a smoke test built from generated cube geometry in
 `examples/demo`. It verifies startup, import composition, scene inspection,
 camera presets, focal length, field of view, camera distance, environment
-rotation, scene saving, camera discovery, and real PNG rendering:
+rotation, scene saving, camera discovery, one-click model rendering, one-click
+existing-scene rendering, and real PNG output:
 
 ```bash
 npm run smoke:keyshot
@@ -254,18 +296,6 @@ Linux.
 - Add depth-of-field and additional lens controls when stable headless APIs are
   available.
 
-### Star history
-
-<picture>
-  <source media="(prefers-color-scheme: dark)" srcset="assets/star-history-dark.svg">
-  <source media="(prefers-color-scheme: light)" srcset="assets/star-history-light.svg">
-  <img alt="GitHub star history for truman-t3/keyshot-mcp" src="assets/star-history-light.svg">
-</picture>
-
-The chart uses the actual `starred_at` date for each GitHub star and displays a
-cumulative step line. A weekly GitHub Action updates it only when detailed
-stargazer dates are available.
-
 ### License and security
 
 Released under the [MIT License](LICENSE). See [SECURITY.md](SECURITY.md) for
@@ -273,6 +303,18 @@ security guidance and [CONTRIBUTING.md](CONTRIBUTING.md) for development notes.
 Do not commit KeyShot licenses, private scenes, customer assets, or unpublished
 renders.
 
+### Trademark and project status
+
+KeyShot is a trademark of KeyShot ApS and/or KeyShot Inc. This is an independent,
+open-source community project and is not affiliated with, endorsed by, or
+sponsored by KeyShot.
+
+This project provides only an MCP integration. It does not include KeyShot
+Studio, KeyShot assets, or a KeyShot license. Users must install and license
+KeyShot Studio separately and comply with the applicable KeyShot terms. Do not
+use this project to bypass licensing, share credentials, or redistribute KeyShot
+software or proprietary resources.
+
 ---
 
 ## 中文
@@ -291,6 +333,7 @@ headless 脚本让兼容 MCP 的 AI Agent 检查、编辑和渲染 KeyShot 场
 - 直接应用材质，或使用本地材质预设库。
 - 选择环境、调整亮度并旋转当前环境。
 - 将修改后的场景保存到受控输出目录。
+- 通过一次工具调用完成模型或现有场景的产品构图与渲染。
 
 ### 运行要求与兼容性
 
@@ -302,7 +345,7 @@ headless 脚本让兼容 MCP 的 AI Agent 检查、编辑和渲染 KeyShot 场
 
 ### 安装
 
-当前版本为 `0.7.0`。
+当前版本为 `0.8.0`。
 
 #### 方式一：使用 npx
 
@@ -313,7 +356,7 @@ headless 脚本让兼容 MCP 的 AI Agent 检查、编辑和渲染 KeyShot 场
   "mcpServers": {
     "keyshot": {
       "command": "npx",
-      "args": ["-y", "keyshot-mcp@0.7.0"],
+      "args": ["-y", "keyshot-mcp@0.8.0"],
       "env": {
         "KEYSHOT_HEADLESS_EXE": "C:/Program Files/KeyShot Studio/bin/keyshot_headless.exe"
       }
@@ -325,7 +368,7 @@ headless 脚本让兼容 MCP 的 AI Agent 检查、编辑和渲染 KeyShot 场
 #### 方式二：全局安装
 
 ```bash
-npm install -g keyshot-mcp@0.7.0
+npm install -g keyshot-mcp@0.8.0
 ```
 
 ```json
@@ -373,14 +416,14 @@ pnpm build
 下面的提示词适用于有权限修改 MCP 客户端配置的编程 Agent：
 
 ```text
-请帮我安装 KeyShot MCP 0.7.0，并添加到我的 MCP 客户端。
+请帮我安装 KeyShot MCP 0.8.0，并添加到我的 MCP 客户端。
 
 1. 查找本机 KeyShot headless 可执行文件。
 2. 添加名为 keyshot 的 MCP server，运行：
-   npx -y keyshot-mcp@0.7.0
+   npx -y keyshot-mcp@0.8.0
 3. 将 KEYSHOT_HEADLESS_EXE 设置为可执行文件路径。
 4. 保持 KEYSHOT_ALLOW_EXTERNAL_OUTPUTS 关闭。
-5. 重启或重新加载 MCP 客户端，然后调用 keyshot_status。
+5. 重启或重新加载 MCP 客户端，调用 keyshot_status，然后使用 keyshot_product_render 一键完成产品出图。
 6. 不要上传或发布任何 KeyShot 场景、模型、渲染图或许可证数据。
 ```
 
@@ -404,6 +447,7 @@ pnpm build
 | 工具 | 用途 |
 | --- | --- |
 | `keyshot_status` | 检查 KeyShot headless 是否可启动并读取版本。 |
+| `keyshot_product_render` | 在一个 headless 进程中完成模型或场景准备、保存和渲染。 |
 | `keyshot_inspect_scene` | 检查对象、相机、材质、模型集和外部引用。 |
 | `keyshot_list_cameras` | 列出场景中的相机名称。 |
 | `keyshot_render` | 渲染一张图片。 |
@@ -420,7 +464,43 @@ pnpm build
 | `keyshot_set_environment` | 选择环境并调整亮度或旋转角度。 |
 | `keyshot_save_scene` | 将场景保存到新的输出路径。 |
 
-服务还提供 `keyshot_product_render` MCP 提示词和 `keyshot://workflow` 资源。
+服务共提供 17 个工具，并提供 `keyshot_product_render` MCP 提示词和
+`keyshot://workflow` 资源。
+
+### 一键产品出图
+
+设计师可以直接在支持 MCP 的 Agent 中描述需求：
+
+```text
+把 C:\models\speaker.obj 做成产品渲染图。自动居中、贴地，使用 Isometric
+相机预设，保存 KeyShot 场景，并用 128 采样渲染一张 1600 x 1200 PNG。
+```
+
+`keyshot_product_render` 可以接收 `modelPath` 或 `scenePath`。新模型默认自动居中、
+贴地并创建名为 `Product Hero` 的等轴测相机；已有场景默认保留当前相机、材质和环境，
+只有明确提供参数时才修改。
+
+```json
+{
+  "modelPath": "C:/models/speaker.obj",
+  "outputScenePath": "speaker-product.bip",
+  "outputPath": "speaker-product.png",
+  "materialAssignments": [
+    { "objectName": "Body", "presetName": "Brushed Steel" }
+  ],
+  "cameraPresetName": "Isometric",
+  "focalLength": 55,
+  "brightness": 1.2,
+  "rotation": 45,
+  "width": 1600,
+  "height": 1200,
+  "samples": 128
+}
+```
+
+将 `renderMode` 设为 `allCameras` 并提供 `outputDir`，即可渲染场景中的全部命名相机。
+省略输出路径时会根据源文件名自动生成。默认不会覆盖已有文件，只有明确设置
+`overwrite: true` 才会替换。材质指定必须包含明确的对象，不会隐式覆盖整个模型。
 
 ### 产品构图示例
 
@@ -474,7 +554,7 @@ pnpm build
 
 仓库提供基于 `examples/demo` 生成立方体几何体的 smoke test，用于验证 KeyShot
 启动、导入构图、场景检查、相机预设、焦距、视野角、相机距离、环境旋转、场景保存、
-相机发现和真实 PNG 渲染：
+相机发现、模型一键出图、现有场景一键渲染全部相机和真实 PNG 输出：
 
 ```bash
 npm run smoke:keyshot
@@ -503,19 +583,17 @@ CI 在 Windows 和 Ubuntu 上使用 Node.js 20、24 运行。Linux CI 验证 MCP
 - 验证 macOS 安装和 headless 行为。
 - 在 headless API 稳定支持后增加景深和更多镜头控制。
 
-### 星标趋势
-
-<picture>
-  <source media="(prefers-color-scheme: dark)" srcset="assets/star-history-dark.svg">
-  <source media="(prefers-color-scheme: light)" srcset="assets/star-history-light.svg">
-  <img alt="truman-t3/keyshot-mcp 的 GitHub 星标趋势" src="assets/star-history-light.svg">
-</picture>
-
-趋势图使用每颗 GitHub Star 的真实 `starred_at` 日期绘制累计阶梯线。GitHub Actions
-每周检查一次，并且只在能够取得逐星日期时更新。
-
 ### 许可证与安全
 
 项目采用 [MIT License](LICENSE)。安全说明见 [SECURITY.md](SECURITY.md)，开发说明
 见 [CONTRIBUTING.md](CONTRIBUTING.md)。请勿提交 KeyShot 许可证、私有场景、客户素材
 或未公开渲染图。
+
+### 商标与项目性质
+
+KeyShot 是 KeyShot ApS 和/或 KeyShot Inc. 的商标。本项目是独立的开源社区项目，
+与 KeyShot 官方无隶属、认可、赞助或其他合作关系。
+
+本项目仅提供 MCP 集成功能，不包含 KeyShot Studio、KeyShot 官方素材或 KeyShot
+许可证。用户必须自行安装并合法授权 KeyShot Studio，同时遵守适用的 KeyShot 条款。
+不得使用本项目绕过许可证、共享账号凭据，或重新分发 KeyShot 软件及其专有资源。

package/dist/index.js

@@ -7,8 +7,9 @@ import { runKeyShotSerialized } from "./runner.js";
 import { runRenderQueue } from "./queue.js";
 import { loadMaterialPresets, findMaterialPreset } from "./presets.js";
 import { loadCameraPresets, findCameraPreset } from "./camera-presets.js";
+import { prepareProductRenderRequest } from "./product-render.js";
 import { VERSION } from "./version.js";
-import { applyMaterialSchema, applyMaterialInputSchema, applyMaterialPresetInputSchema, applyMaterialPresetSchema, applyCameraPresetSchema, batchRenderSchema, batchRenderInputSchema, importModelSchema, listCamerasSchema, listMaterialPresetsSchema, listCameraPresetsSchema, renderQueueSchema, renderQueueInputSchema, renderAllCamerasSchema, renderAllCamerasInputSchema, renderSchema, renderInputSchema, saveSceneSchema, scenePathSchema, setCameraInputSchema, setCameraSchema, setEnvironmentSchema, } from "./schemas.js";
+import { applyMaterialSchema, applyMaterialInputSchema, applyMaterialPresetInputSchema, applyMaterialPresetSchema, applyCameraPresetSchema, batchRenderSchema, batchRenderInputSchema, importModelSchema, listCamerasSchema, listMaterialPresetsSchema, listCameraPresetsSchema, productRenderInputSchema, productRenderSchema, renderQueueSchema, renderQueueInputSchema, renderAllCamerasSchema, renderAllCamerasInputSchema, renderSchema, renderInputSchema, saveSceneSchema, scenePathSchema, setCameraInputSchema, setCameraSchema, setEnvironmentSchema, } from "./schemas.js";
 const config = getConfig();
 const server = new McpServer({
     name: "keyshot-mcp",
@@ -39,6 +40,7 @@ server.registerPrompt("keyshot_product_render", {
     title: "Render a KeyShot product scene",
     description: "Create a practical prompt for rendering or batch-rendering a KeyShot product scene.",
     argsSchema: {
+        modelPath: scenePathSchema.shape.scenePath.optional(),
         scenePath: scenePathSchema.shape.scenePath.optional(),
         goal: scenePathSchema.shape.scenePath.optional(),
     },
@@ -50,15 +52,29 @@ server.registerPrompt("keyshot_product_render", {
                 type: "text",
                 text: [
                     "Use KeyShot MCP to prepare a product render.",
-                    args.scenePath ? `Scene path: ${args.scenePath}` : "Ask me for the KeyShot scene path first.",
+                    args.modelPath
+                        ? `Model path: ${args.modelPath}`
+                        : args.scenePath
+                            ? `Scene path: ${args.scenePath}`
+                            : "Ask me for either a model path or a KeyShot scene path first.",
                     args.goal ? `Goal: ${args.goal}` : "Inspect the scene, choose a suitable camera, then render a PNG preview.",
-                    "Start with keyshot_status, then keyshot_inspect_scene, then render or batch render as needed.",
+                    "Call the keyshot_product_render tool for the complete workflow. Use the lower-level tools only when individual steps need manual control.",
                 ].join("\n"),
             },
         },
     ],
 }));
 server.tool("keyshot_status", "Check KeyShot headless availability and script startup.", {}, async () => toolResponse(await runKeyShotSerialized(config, { operation: "status" })));
+server.tool("keyshot_product_render", "Prepare and render a product from either a model file or an existing KeyShot scene in one headless process.", productRenderInputSchema.shape, async (args) => {
+    try {
+        const parsed = productRenderSchema.parse(args);
+        const request = await prepareProductRenderRequest(config, parsed);
+        return toolResponse(await runKeyShotSerialized(config, request));
+    }
+    catch (error) {
+        return toolResponse(localFailure(errorMessage(error)));
+    }
+});
 server.tool("keyshot_inspect_scene", "Open a KeyShot scene and return available objects, cameras, materials and scene metadata.", scenePathSchema.shape, async (args) => toolResponse(await runKeyShotSerialized(config, { operation: "inspect_scene", ...args })));
 server.tool("keyshot_list_cameras", "Open a KeyShot scene and return the list of available camera names (useful before batch rendering).", listCamerasSchema.shape, async (args) => toolResponse(await runKeyShotSerialized(config, { operation: "list_cameras", ...args })));
 server.tool("keyshot_render", "Render a KeyShot scene to an image file.", renderSchema.shape, async (args) => {

package/dist/product-render.js

@@ -0,0 +1,83 @@
+import path from "node:path";
+import { findCameraPreset, loadCameraPresets } from "./camera-presets.js";
+import { findMaterialPreset, loadMaterialPresets } from "./presets.js";
+export async function prepareProductRenderRequest(config, input) {
+    const sourcePath = input.modelPath ?? input.scenePath;
+    const stem = safeStem(sourcePath);
+    const format = input.format ?? "png";
+    const renderMode = input.renderMode ?? "single";
+    const request = {
+        ...input,
+        operation: "product_render",
+        renderMode,
+        format,
+        outputScenePath: input.outputScenePath ?? `${stem}-product.bip`,
+        overwrite: input.overwrite ?? false,
+        continueOnError: input.continueOnError ?? true,
+    };
+    if (renderMode === "single") {
+        request.outputPath = input.outputPath ?? `${stem}-product.${format}`;
+        delete request.outputDir;
+    }
+    else {
+        request.outputDir = input.outputDir ?? `${stem}-renders`;
+        delete request.outputPath;
+    }
+    if (input.modelPath) {
+        request.centerGeometry = input.centerGeometry ?? true;
+        request.snapToGround = input.snapToGround ?? true;
+        request.adjustCameraLookAt = input.adjustCameraLookAt ?? true;
+        request.adjustEnvironment = input.adjustEnvironment ?? true;
+    }
+    request.materialAssignments = await resolveMaterialAssignments(config, input.materialAssignments ?? []);
+    const presetName = input.cameraPresetName ?? (input.modelPath ? "Isometric" : undefined);
+    if (presetName) {
+        const presets = await loadCameraPresets(config);
+        const preset = findCameraPreset(presets, presetName);
+        if (!preset) {
+            const available = presets.map((entry) => entry.name).join(", ") || "(none)";
+            throw new Error(`Camera preset not found: "${presetName}". Available: ${available}`);
+        }
+        request.cameraPresetName = preset.name;
+        request.cameraName = input.cameraName ?? (input.modelPath ? "Product Hero" : preset.name);
+        if (preset.type === "standard") {
+            request.standardView = preset.standardView;
+        }
+        else {
+            request.position = preset.position;
+            request.lookAt = preset.lookAt;
+            request.up = preset.up;
+        }
+    }
+    else if (input.modelPath) {
+        request.cameraName = input.cameraName ?? "Product Hero";
+    }
+    return request;
+}
+async function resolveMaterialAssignments(config, assignments) {
+    if (assignments.length === 0)
+        return [];
+    const needsPresets = assignments.some((assignment) => assignment.presetName !== undefined);
+    const presets = needsPresets ? await loadMaterialPresets(config) : [];
+    return assignments.map((assignment) => {
+        if (!assignment.presetName)
+            return { ...assignment };
+        const preset = findMaterialPreset(presets, assignment.presetName);
+        if (!preset) {
+            const available = presets.map((entry) => entry.name).join(", ") || "(none)";
+            throw new Error(`Material preset not found: "${assignment.presetName}". Available: ${available}`);
+        }
+        return {
+            objectName: assignment.objectName,
+            objectPath: assignment.objectPath,
+            presetName: preset.name,
+            materialName: preset.materialName,
+            materialPath: preset.materialPath,
+        };
+    });
+}
+function safeStem(sourcePath) {
+    const parsed = path.parse(sourcePath);
+    const normalized = parsed.name.trim().replace(/[^a-zA-Z0-9._-]+/g, "-").replace(/^-+|-+$/g, "");
+    return normalized || "product";
+}

package/dist/runner.js

@@ -30,6 +30,22 @@ async function runKeyShot(config, request) {
     catch (error) {
         return localFailure(errorMessage(error));
     }
+    if (normalizedRequest.operation === "product_render") {
+        for (const field of ["modelPath", "baseScenePath"]) {
+            const value = normalizedRequest[field];
+            if (typeof value === "string" && !(await exists(value))) {
+                return localFailure(`${field === "modelPath" ? "Model" : "Base scene"} file not found: ${value}`);
+            }
+        }
+        if (normalizedRequest.overwrite !== true) {
+            const protectedOutputs = [normalizedRequest.outputScenePath, normalizedRequest.outputPath];
+            for (const output of protectedOutputs) {
+                if (typeof output === "string" && await exists(output)) {
+                    return localFailure(`Output already exists and overwrite is false: ${output}`);
+                }
+            }
+        }
+    }
     const id = `${Date.now()}-${randomUUID()}`;
     const argsPath = path.join(config.tmpDir, `${id}.args.json`);
     const resultPath = path.join(config.tmpDir, `${id}.result.json`);

package/dist/schemas.js

@@ -74,6 +74,94 @@ export const applyMaterialSchema = applyMaterialInputSchema.refine((value) => va
     message: "Provide materialName or materialPath.",
 });
 const vector3 = z.tuple([z.number(), z.number(), z.number()]);
+export const productMaterialAssignmentSchema = z.object({
+    objectName: z.string().min(1).optional(),
+    objectPath: z.string().min(1).optional(),
+    presetName: z.string().min(1).optional(),
+    materialName: z.string().min(1).optional(),
+    materialPath: z.string().min(1).optional(),
+}).superRefine((value, context) => {
+    const targets = [value.objectName, value.objectPath].filter((item) => item !== undefined);
+    const materials = [value.presetName, value.materialName, value.materialPath].filter((item) => item !== undefined);
+    if (targets.length !== 1) {
+        context.addIssue({ code: z.ZodIssueCode.custom, message: "Choose exactly one objectName or objectPath." });
+    }
+    if (materials.length !== 1) {
+        context.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "Choose exactly one presetName, materialName, or materialPath.",
+        });
+    }
+});
+export const productRenderInputSchema = z.object({
+    modelPath: optionalPath,
+    scenePath: optionalPath,
+    baseScenePath: optionalPath,
+    outputScenePath: optionalPath,
+    renderMode: z.enum(["single", "allCameras"]).default("single"),
+    outputPath: optionalPath,
+    outputDir: optionalPath,
+    centerGeometry: z.boolean().optional(),
+    snapToGround: z.boolean().optional(),
+    adjustCameraLookAt: z.boolean().optional(),
+    adjustEnvironment: z.boolean().optional(),
+    materialAssignments: z.array(productMaterialAssignmentSchema).optional(),
+    cameraPresetName: z.string().min(1).optional(),
+    cameraName: z.string().min(1).optional(),
+    position: vector3.optional(),
+    lookAt: vector3.optional(),
+    up: vector3.optional(),
+    distance: z.number().positive().optional(),
+    fieldOfView: z.number().gt(0).lt(180).optional(),
+    focalLength: z.number().min(5).max(200).optional(),
+    environmentName: z.string().min(1).optional(),
+    environmentPath: z.string().min(1).optional(),
+    brightness: z.number().positive().optional(),
+    rotation: z.number().min(0).lt(360).optional(),
+    width: z.number().int().positive().optional(),
+    height: z.number().int().positive().optional(),
+    samples: z.number().int().positive().optional(),
+    maxTimeSeconds: z.number().positive().optional(),
+    format: imageFormat.optional(),
+    overwrite: z.boolean().default(false),
+    continueOnError: z.boolean().default(true),
+});
+export const productRenderSchema = productRenderInputSchema.superRefine((value, context) => {
+    if ((value.modelPath === undefined) === (value.scenePath === undefined)) {
+        context.addIssue({ code: z.ZodIssueCode.custom, message: "Provide exactly one modelPath or scenePath." });
+    }
+    if (value.baseScenePath !== undefined && value.modelPath === undefined) {
+        context.addIssue({ code: z.ZodIssueCode.custom, message: "baseScenePath requires modelPath.", path: ["baseScenePath"] });
+    }
+    const importFields = ["centerGeometry", "snapToGround", "adjustCameraLookAt", "adjustEnvironment"];
+    if (value.scenePath !== undefined && importFields.some((field) => value[field] !== undefined)) {
+        context.addIssue({ code: z.ZodIssueCode.custom, message: "Import options can only be used with modelPath." });
+    }
+    if (value.renderMode === "single" && value.outputDir !== undefined) {
+        context.addIssue({ code: z.ZodIssueCode.custom, message: "outputDir is only valid for allCameras mode.", path: ["outputDir"] });
+    }
+    if (value.renderMode === "allCameras" && value.outputPath !== undefined) {
+        context.addIssue({ code: z.ZodIssueCode.custom, message: "outputPath is only valid for single mode.", path: ["outputPath"] });
+    }
+    if ((value.position === undefined) !== (value.lookAt === undefined)) {
+        context.addIssue({ code: z.ZodIssueCode.custom, message: "Provide position and lookAt together.", path: ["lookAt"] });
+    }
+    if (value.up !== undefined && value.position === undefined) {
+        context.addIssue({ code: z.ZodIssueCode.custom, message: "up requires position and lookAt.", path: ["up"] });
+    }
+    if (value.cameraPresetName !== undefined && value.position !== undefined) {
+        context.addIssue({ code: z.ZodIssueCode.custom, message: "cameraPresetName cannot be combined with a custom position." });
+    }
+    if (value.fieldOfView !== undefined && value.focalLength !== undefined) {
+        context.addIssue({ code: z.ZodIssueCode.custom, message: "Choose either fieldOfView or focalLength, not both.", path: ["focalLength"] });
+    }
+    if (value.environmentName !== undefined && value.environmentPath !== undefined) {
+        context.addIssue({ code: z.ZodIssueCode.custom, message: "Choose either environmentName or environmentPath, not both." });
+    }
+    if (value.samples !== undefined && value.maxTimeSeconds !== undefined) {
+        context.addIssue({ code: z.ZodIssueCode.custom, message: "Choose either samples or maxTimeSeconds, not both.", path: ["maxTimeSeconds"] });
+    }
+});
 const setCameraBaseSchema = z.object({
     scenePath: z.string().min(1),
     cameraName: z.string().min(1).optional(),

package/dist/version.js

@@ -1 +1 @@
-export const VERSION = "0.7.0";
+export const VERSION = "0.8.0";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "keyshot-mcp",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "mcpName": "io.github.truman-t3/keyshot-mcp",
   "description": "Local MCP server for KeyShot product visualization, scene editing, camera control, and rendering.",
   "type": "module",

package/scripts/keyshot-smoke.mjs

@@ -4,6 +4,7 @@ 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 { prepareProductRenderRequest } from "../dist/product-render.js";
 import { runKeyShotSerialized } from "../dist/runner.js";
 
 const repoRoot = path.resolve(fileURLToPath(new URL("..", import.meta.url)));
@@ -36,8 +37,8 @@ async function applyStandardPreset(label, scenePath, presetName, outputScenePath
   });
 }
 
-const status = await run("1/11 KeyShot status", { operation: "status" });
-const imported = await run("2/11 Import, center, and ground generated OBJ", {
+const status = await run("1/13 KeyShot status", { operation: "status" });
+const imported = await run("2/13 Import, center, and ground generated OBJ", {
   operation: "import_model",
   modelPath,
   outputScenePath: "demo/keyshot-mcp-demo-import.bip",
@@ -49,7 +50,7 @@ const imported = await run("2/11 Import, center, and ground generated OBJ", {
 const importedScene = imported.outputFiles[0];
 if (!importedScene) throw new Error("Import did not return a saved scene path.");
 
-const inspected = await run("3/11 Inspect imported scene", {
+const inspected = await run("3/13 Inspect imported scene", {
   operation: "inspect_scene",
   scenePath: importedScene,
 });
@@ -59,7 +60,7 @@ if (!Array.isArray(objects) || objects.length === 0) {
 }
 
 const firstCameraResult = await applyStandardPreset(
-  "4/11 Apply Front camera preset",
+  "4/13 Apply Front camera preset",
   importedScene,
   "Front",
   "demo/keyshot-mcp-demo-preset-front.bip",
@@ -67,7 +68,7 @@ const firstCameraResult = await applyStandardPreset(
 const firstCameraScene = firstCameraResult.outputFiles[0];
 if (!firstCameraScene) throw new Error("Front preset did not return a saved scene path.");
 
-const focalLengthResult = await run("5/11 Set Front camera focal length", {
+const focalLengthResult = await run("5/13 Set Front camera focal length", {
   operation: "set_camera",
   scenePath: firstCameraScene,
   cameraName: "Front",
@@ -77,7 +78,7 @@ const focalLengthResult = await run("5/11 Set Front camera focal length", {
 const focalLengthScene = focalLengthResult.outputFiles[0];
 if (!focalLengthScene) throw new Error("Focal-length update did not return a saved scene path.");
 
-const environmentResult = await run("6/11 Rotate the active environment", {
+const environmentResult = await run("6/13 Rotate the active environment", {
   operation: "set_environment",
   scenePath: focalLengthScene,
   rotation: 45,
@@ -87,7 +88,7 @@ const environmentScene = environmentResult.outputFiles[0];
 if (!environmentScene) throw new Error("Environment update did not return a saved scene path.");
 
 const secondCameraResult = await applyStandardPreset(
-  "7/11 Apply Isometric camera preset",
+  "7/13 Apply Isometric camera preset",
   environmentScene,
   "Isometric",
   "demo/keyshot-mcp-demo-presets.bip",
@@ -95,7 +96,7 @@ const secondCameraResult = await applyStandardPreset(
 const cameraScene = secondCameraResult.outputFiles[0];
 if (!cameraScene) throw new Error("Isometric preset did not return a saved scene path.");
 
-const fieldOfViewResult = await run("8/11 Set Isometric camera field of view and distance", {
+const fieldOfViewResult = await run("8/13 Set Isometric camera field of view and distance", {
   operation: "set_camera",
   scenePath: cameraScene,
   cameraName: "Isometric",
@@ -106,7 +107,7 @@ const fieldOfViewResult = await run("8/11 Set Isometric camera field of view and
 const productCameraScene = fieldOfViewResult.outputFiles[0];
 if (!productCameraScene) throw new Error("Field-of-view update did not return a saved scene path.");
 
-const rendered = await run("9/11 Discover and render every camera", {
+const rendered = await run("9/13 Discover and render every camera", {
   operation: "render_all_cameras",
   scenePath: productCameraScene,
   outputDir: "demo/all-cameras",
@@ -139,8 +140,42 @@ const minimumSizes = await Promise.all(namedResults.map(async (entry) => (await
 if (minimumSizes.some((size) => size < 10000)) {
   throw new Error("A demo camera render is unexpectedly small and may be blank.");
 }
-process.stdout.write("10/11 Verify two different camera images... ok\n");
-process.stdout.write("11/11 Verify composition, lens, and environment operations... ok\n");
+process.stdout.write("10/13 Verify two different camera images... ok\n");
+process.stdout.write("11/13 Verify composition, lens, and environment operations... ok\n");
+
+const oneClickModelRequest = await prepareProductRenderRequest(config, {
+  modelPath,
+  outputScenePath: "demo/one-click-cube.bip",
+  outputPath: "demo/one-click-cube.png",
+  renderMode: "single",
+  width: 640,
+  height: 480,
+  maxTimeSeconds: 8,
+  format: "png",
+  overwrite: true,
+  continueOnError: true,
+});
+const oneClickModel = await run("12/13 One-click model-to-product render", oneClickModelRequest);
+if (!oneClickModel.data?.savedScene || oneClickModel.data?.renders?.length !== 1) {
+  throw new Error("One-click model workflow did not return a scene and one render.");
+}
+
+const oneClickSceneRequest = await prepareProductRenderRequest(config, {
+  scenePath: productCameraScene,
+  outputScenePath: "demo/one-click-existing-scene.bip",
+  outputDir: "demo/one-click-all-cameras",
+  renderMode: "allCameras",
+  width: 640,
+  height: 480,
+  maxTimeSeconds: 8,
+  format: "png",
+  overwrite: true,
+  continueOnError: true,
+});
+const oneClickScene = await run("13/13 One-click existing-scene all-camera render", oneClickSceneRequest);
+if (!oneClickScene.data?.savedScene || oneClickScene.data?.renders?.length < 2) {
+  throw new Error("One-click scene workflow did not preserve the scene and render all cameras.");
+}
 
 console.log(JSON.stringify({
   keyshotVersion: status.data?.version ?? null,
@@ -148,6 +183,7 @@ console.log(JSON.stringify({
   scenePath: productCameraScene,
   cameraCount: renderData.total,
   renderedImages: rendered.outputFiles,
+  oneClickOutputs: [...oneClickModel.outputFiles, ...oneClickScene.outputFiles],
   verifiedPresets: namedResults.map((entry) => entry.camera),
   verifiedControls: {
     importOptions: ["centerGeometry", "snapToGround", "adjustCameraLookAt", "adjustEnvironment"],

package/scripts/keyshot_bridge.py

@@ -39,6 +39,8 @@ def main():
             data = batch_render(payload, output_files, warnings)
         elif operation == "render_all_cameras":
             data = render_all_cameras(payload, output_files, warnings)
+        elif operation == "product_render":
+            data = product_render(payload, output_files, warnings)
         elif operation == "import_model":
             data = import_model(payload, output_files, warnings)
         elif operation == "apply_material":
@@ -57,6 +59,8 @@ def main():
         operation_error = None
         if operation == "render_all_cameras" and data.get("failed", 0) > 0:
             operation_error = "%s of %s camera render(s) failed." % (data["failed"], data["total"])
+        elif operation == "product_render":
+            operation_error = data.get("operationError")
         write_result(result_path, operation_error is None, data, output_files, warnings, operation_error)
     except Exception as exc:
         warnings.append(traceback.format_exc())
@@ -227,6 +231,13 @@ def batch_render(payload, output_files, warnings):
 
 
 def render_all_cameras(payload, output_files, warnings):
+    scene_path = payload.get("scenePath")
+    if not scene_path:
+        raise RuntimeError("scenePath is required")
+    return render_all_cameras_current(payload, output_files, warnings)
+
+
+def render_all_cameras_current(payload, output_files, warnings):
     scene_path = payload.get("scenePath")
     output_dir = payload.get("outputDir")
     discovered_cameras = camera_names()
@@ -238,8 +249,6 @@ def render_all_cameras(payload, output_files, warnings):
     overwrite = bool(payload.get("overwrite", False))
     continue_on_error = payload.get("continueOnError", True) is not False
 
-    if not scene_path:
-        raise RuntimeError("scenePath is required")
     if not output_dir:
         raise RuntimeError("outputDir is required")
     if not cameras:
@@ -320,14 +329,168 @@ def unique_camera_output_path(output_dir, camera, image_format, used_stems):
     return os.path.join(output_dir, "%s.%s" % (stem, image_format))
 
 
+def product_render(payload, output_files, warnings):
+    stages = []
+    source_type = "model" if payload.get("modelPath") else "scene"
+    source_path = payload.get("modelPath") or payload.get("scenePath")
+    result = {
+        "sourceType": source_type,
+        "sourcePath": source_path,
+        "savedScene": None,
+        "renderMode": payload.get("renderMode") or "single",
+        "renders": [],
+        "materialAssignments": [],
+        "camera": None,
+        "environment": None,
+        "stages": stages,
+        "operationError": None,
+    }
+
+    try:
+        if source_type == "model":
+            source_data = import_model_current(payload, warnings)
+        else:
+            if not source_path:
+                raise RuntimeError("scenePath is required")
+            source_data = {"openedScene": source_path}
+        stages.append(product_stage("source", True, source_data))
+    except Exception as exc:
+        return product_failure(result, stages, "source", exc, warnings)
+
+    assignments = payload.get("materialAssignments") or []
+    try:
+        applied_materials = [apply_material_current(assignment, warnings) for assignment in assignments]
+        result["materialAssignments"] = applied_materials
+        stages.append(product_stage("materials", True, applied_materials, len(assignments) == 0))
+    except Exception as exc:
+        return product_failure(result, stages, "materials", exc, warnings)
+
+    try:
+        camera_data = configure_product_camera(payload, output_files, warnings)
+        result["camera"] = camera_data
+        stages.append(product_stage("camera", True, camera_data, camera_data is None))
+    except Exception as exc:
+        return product_failure(result, stages, "camera", exc, warnings)
+
+    environment_requested = any(
+        payload.get(name) is not None
+        for name in ("environmentName", "environmentPath", "brightness", "rotation")
+    )
+    try:
+        environment_data = set_environment(payload, output_files, warnings, persist=False) if environment_requested else None
+        result["environment"] = environment_data
+        stages.append(product_stage("environment", True, environment_data, not environment_requested))
+    except Exception as exc:
+        return product_failure(result, stages, "environment", exc, warnings)
+
+    output_scene_path = payload.get("outputScenePath")
+    try:
+        if not output_scene_path:
+            raise RuntimeError("outputScenePath is required")
+        save_to(output_scene_path)
+        output_files.append(output_scene_path)
+        result["savedScene"] = output_scene_path
+        stages.append(product_stage("save", True, {"savedScene": output_scene_path}))
+    except Exception as exc:
+        return product_failure(result, stages, "save", exc, warnings)
+
+    try:
+        if result["renderMode"] == "allCameras":
+            render_payload = dict(payload)
+            render_payload["scenePath"] = output_scene_path
+            render_data = render_all_cameras_current(render_payload, output_files, warnings)
+            result["renders"] = render_data.get("results", [])
+            render_ok = render_data.get("failed", 0) == 0
+            stages.append(product_stage("render", render_ok, render_data))
+            if not render_ok:
+                result["operationError"] = "%s of %s camera render(s) failed." % (
+                    render_data.get("failed", 0),
+                    render_data.get("total", 0),
+                )
+        else:
+            output_path = payload.get("outputPath")
+            if not output_path:
+                raise RuntimeError("outputPath is required for single render mode")
+            if os.path.exists(output_path) and not payload.get("overwrite", False):
+                raise RuntimeError("Output already exists and overwrite is false: %s" % output_path)
+            render_payload = dict(payload)
+            if payload.get("cameraName"):
+                render_payload["camera"] = payload.get("cameraName")
+            render_data = render(render_payload, output_files, warnings)
+            result["renders"] = [{"camera": render_payload.get("camera"), "outputPath": render_data["rendered"], "ok": True}]
+            stages.append(product_stage("render", True, render_data))
+    except Exception as exc:
+        return product_failure(result, stages, "render", exc, warnings)
+
+    return result
+
+
+def configure_product_camera(payload, output_files, warnings):
+    camera_name = payload.get("cameraName")
+    standard_view = payload.get("standardView")
+    transform_requested = payload.get("position") is not None
+    lens_requested = any(payload.get(name) is not None for name in ("distance", "fieldOfView", "focalLength"))
+
+    if standard_view:
+        standard_data = set_standard_camera(payload, output_files, warnings, persist=False)
+        if lens_requested:
+            lens_payload = {
+                "cameraName": camera_name,
+                "distance": payload.get("distance"),
+                "fieldOfView": payload.get("fieldOfView"),
+                "focalLength": payload.get("focalLength"),
+            }
+            lens_data = set_camera(lens_payload, output_files, warnings, persist=False)
+            standard_data.update({
+                "distance": lens_data.get("distance"),
+                "fieldOfView": lens_data.get("fieldOfView"),
+                "focalLength": lens_data.get("focalLength"),
+            })
+        standard_data["presetName"] = payload.get("cameraPresetName")
+        return standard_data
+
+    if transform_requested or lens_requested:
+        camera_data = set_camera(payload, output_files, warnings, persist=False)
+        camera_data["presetName"] = payload.get("cameraPresetName")
+        return camera_data
+
+    if camera_name:
+        if camera_name not in camera_names():
+            raise RuntimeError("Camera not found: %s" % camera_name)
+        call_non_false_variants("activate camera", lambda: lux.setCamera(camera_name))
+        return {"cameraName": camera_name, "selected": True}
+
+    return None
+
+
+def product_stage(name, ok, data=None, skipped=False, error=None):
+    return {"name": name, "ok": ok, "skipped": skipped, "data": data, "error": error}
+
+
+def product_failure(result, stages, stage_name, error, warnings):
+    message = "Product render stage '%s' failed: %s" % (stage_name, error)
+    stages.append(product_stage(stage_name, False, error=str(error)))
+    warnings.append(message)
+    result["operationError"] = message
+    return result
+
+
 def import_model(payload, output_files, warnings):
-    model_path = payload.get("modelPath")
+    data = import_model_current(payload, warnings)
     output_scene_path = payload.get("outputScenePath")
+    if not output_scene_path:
+        raise RuntimeError("outputScenePath is required")
+    save_to(output_scene_path)
+    output_files.append(output_scene_path)
+    data["savedScene"] = output_scene_path
+    return data
+
+
+def import_model_current(payload, warnings):
+    model_path = payload.get("modelPath")
     base_scene_path = payload.get("baseScenePath")
     if not model_path or not os.path.exists(model_path):
         raise RuntimeError("Model file not found: %s" % model_path)
-    if not output_scene_path:
-        raise RuntimeError("outputScenePath is required")
 
     if base_scene_path:
         if not os.path.exists(base_scene_path):
@@ -374,13 +537,10 @@ def import_model(payload, output_files, warnings):
             lambda: lux.importFile(model_path),
             lambda: lux.importFile(str(model_path)),
         )
-    save_to(output_scene_path)
-    output_files.append(output_scene_path)
     return {
         "importedModel": model_path,
         "baseScene": base_scene_path,
         "importOptions": requested_options,
-        "savedScene": output_scene_path,
     }
 
 
@@ -407,7 +567,17 @@ def new_scene(warnings):
 
 
 def apply_material(payload, output_files, warnings):
+    data = apply_material_current(payload, warnings)
     output_scene_path = payload.get("outputScenePath")
+    if not output_scene_path:
+        raise RuntimeError("outputScenePath is required")
+    save_to(output_scene_path)
+    output_files.append(output_scene_path)
+    data["savedScene"] = output_scene_path
+    return data
+
+
+def apply_material_current(payload, warnings):
     target = find_object(payload.get("objectName"), payload.get("objectPath"))
     if target is None:
         raise RuntimeError("Object not found. Provide a valid objectName or objectPath.")
@@ -420,16 +590,14 @@ def apply_material(payload, output_files, warnings):
         lambda: lux.setObjectMaterial(target, payload.get("materialPath")),
     )
 
-    save_to(output_scene_path)
-    output_files.append(output_scene_path)
     return {
         "object": describe_object(target),
         "material": serialize_value(material),
-        "savedScene": output_scene_path,
+        "presetName": payload.get("presetName"),
     }
 
 
-def set_camera(payload, output_files, warnings):
+def set_camera(payload, output_files, warnings, persist=True):
     output_scene_path = payload.get("outputScenePath")
     camera_name = payload.get("cameraName") or "MCP Camera"
     position = payload.get("position")
@@ -533,9 +701,7 @@ def set_camera(payload, output_files, warnings):
         except RuntimeError:
             warnings.append("The camera was updated, but this KeyShot version could not save the named view.")
 
-    save_to(output_scene_path)
-    output_files.append(output_scene_path)
-    return {
+    data = {
         "cameraName": camera_name,
         "position": position,
         "lookAt": look_at,
@@ -543,11 +709,17 @@ def set_camera(payload, output_files, warnings):
         "distance": distance,
         "fieldOfView": field_of_view,
         "focalLength": focal_length,
-        "savedScene": output_scene_path,
     }
+    if persist:
+        if not output_scene_path:
+            raise RuntimeError("outputScenePath is required")
+        save_to(output_scene_path)
+        output_files.append(output_scene_path)
+        data["savedScene"] = output_scene_path
+    return data
 
 
-def set_standard_camera(payload, output_files, warnings):
+def set_standard_camera(payload, output_files, warnings, persist=True):
     output_scene_path = payload.get("outputScenePath")
     camera_name = payload.get("cameraName") or "MCP Camera"
     standard_view = str(payload.get("standardView") or "").lower()
@@ -586,16 +758,20 @@ def set_standard_camera(payload, output_files, warnings):
         lambda: lux.saveCamera(),
         lambda: lux.saveCamera(camera_name),
     )
-    save_to(output_scene_path)
-    output_files.append(output_scene_path)
-    return {
+    data = {
         "cameraName": camera_name,
         "standardView": standard_view,
-        "savedScene": output_scene_path,
     }
+    if persist:
+        if not output_scene_path:
+            raise RuntimeError("outputScenePath is required")
+        save_to(output_scene_path)
+        output_files.append(output_scene_path)
+        data["savedScene"] = output_scene_path
+    return data
 
 
-def set_environment(payload, output_files, warnings):
+def set_environment(payload, output_files, warnings, persist=True):
     output_scene_path = payload.get("outputScenePath")
     environment_name = payload.get("environmentName")
     environment_path = payload.get("environmentPath")
@@ -616,6 +792,7 @@ def set_environment(payload, output_files, warnings):
     elif environment_name:
         call_variants(
             "set environment name",
+            lambda: lux.setActiveEnvironment(environment_name),
             lambda: lux.setEnvironment(environment_name),
             lambda: lux.setEnvironmentByName(environment_name),
         )
@@ -648,15 +825,19 @@ def set_environment(payload, output_files, warnings):
     if not changed:
         raise RuntimeError("No supported environment change was requested.")
 
-    save_to(output_scene_path)
-    output_files.append(output_scene_path)
-    return {
+    data = {
         "environmentName": environment_name,
         "environmentPath": environment_path,
         "brightness": brightness,
         "rotation": rotation,
-        "savedScene": output_scene_path,
     }
+    if persist:
+        if not output_scene_path:
+            raise RuntimeError("outputScenePath is required")
+        save_to(output_scene_path)
+        output_files.append(output_scene_path)
+        data["savedScene"] = output_scene_path
+    return data
 
 
 def active_environment():

package/server.json

@@ -2,19 +2,19 @@
   "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
   "name": "io.github.truman-t3/keyshot-mcp",
   "title": "KeyShot MCP",
-  "description": "Control local KeyShot product visualization, scene editing, cameras, environments, and rendering through headless scripting.",
+  "description": "Control local KeyShot scenes, cameras, environments, and renders through headless scripting.",
   "websiteUrl": "https://github.com/truman-t3/keyshot-mcp",
   "repository": {
     "id": "1290741614",
     "url": "https://github.com/truman-t3/keyshot-mcp",
     "source": "github"
   },
-  "version": "0.7.0",
+  "version": "0.8.0",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "keyshot-mcp",
-      "version": "0.7.0",
+      "version": "0.8.0",
       "transport": {
         "type": "stdio"
       },

package/assets/star-history-dark.svg

@@ -1,25 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" width="720" height="360" viewBox="0 0 720 360" role="img" aria-labelledby="title desc">
-  <title id="title">Star History for truman-t3/keyshot-mcp</title>
-  <desc id="desc">5 GitHub stars through 2026-07-20, plotted by the date each star was added.</desc>
-  <style>
-    .text { fill: #c9d1d9; font: 16px -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; }
-    .title { fill: #f0f6fc; font: 700 26px -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; }
-    .muted { fill: #8b949e; font: 14px -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; }
-  </style>
-  <rect fill="#0d1117" width="720" height="360" rx="16"/>
-  <rect fill="#161b22" stroke="#30363d" x="32" y="32" width="656" height="296" rx="12"/>
-  <text class="title" x="64" y="78">Star History</text>
-  <text class="muted" x="64" y="104">truman-t3/keyshot-mcp</text>
-  <rect fill="#21262d" stroke="#30363d" x="548" y="55" width="92" height="36" rx="18"/>
-  <text class="text" x="571" y="79">&#9733; 5</text>
-  <line stroke="#30363d" x1="88" y1="258" x2="632" y2="258"/>
-  <line stroke="#30363d" x1="88" y1="128" x2="88" y2="258"/>
-  <text class="muted" x="66" y="263">0</text>
-  <text class="muted" x="66" y="136">5</text>
-  <text class="muted" x="88" y="288">2026-07-06</text>
-  <text class="muted" x="555" y="288">2026-07-20</text>
-  <path fill="none" stroke="#58a6ff" stroke-width="4" stroke-linecap="round" stroke-linejoin="round" d="M 88 258 H 88.00 V 128.00 H 632"/>
-  <circle fill="#58a6ff" stroke="#0d1117" stroke-width="3" cx="88.00" cy="128.00" r="6"/>
-  <circle fill="#58a6ff" stroke="#0d1117" stroke-width="3" cx="632" cy="128.00" r="7"/>
-  <text class="text" x="486" y="122">Current stars: 5</text>
-</svg>

package/assets/star-history-light.svg

@@ -1,25 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" width="720" height="360" viewBox="0 0 720 360" role="img" aria-labelledby="title desc">
-  <title id="title">Star History for truman-t3/keyshot-mcp</title>
-  <desc id="desc">5 GitHub stars through 2026-07-20, plotted by the date each star was added.</desc>
-  <style>
-    .text { fill: #24292f; font: 16px -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; }
-    .title { fill: #1f2328; font: 700 26px -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; }
-    .muted { fill: #57606a; font: 14px -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; }
-  </style>
-  <rect fill="#ffffff" width="720" height="360" rx="16"/>
-  <rect fill="#f6f8fa" stroke="#d0d7de" x="32" y="32" width="656" height="296" rx="12"/>
-  <text class="title" x="64" y="78">Star History</text>
-  <text class="muted" x="64" y="104">truman-t3/keyshot-mcp</text>
-  <rect fill="#ffffff" stroke="#d0d7de" x="548" y="55" width="92" height="36" rx="18"/>
-  <text class="text" x="571" y="79">&#9733; 5</text>
-  <line stroke="#d0d7de" x1="88" y1="258" x2="632" y2="258"/>
-  <line stroke="#d0d7de" x1="88" y1="128" x2="88" y2="258"/>
-  <text class="muted" x="66" y="263">0</text>
-  <text class="muted" x="66" y="136">5</text>
-  <text class="muted" x="88" y="288">2026-07-06</text>
-  <text class="muted" x="555" y="288">2026-07-20</text>
-  <path fill="none" stroke="#0969da" stroke-width="4" stroke-linecap="round" stroke-linejoin="round" d="M 88 258 H 88.00 V 128.00 H 632"/>
-  <circle fill="#0969da" stroke="#ffffff" stroke-width="3" cx="88.00" cy="128.00" r="6"/>
-  <circle fill="#0969da" stroke="#ffffff" stroke-width="3" cx="632" cy="128.00" r="7"/>
-  <text class="text" x="486" y="122">Current stars: 5</text>
-</svg>