freeform-modeling-mcp 1.0.34 → 1.0.35

package/.cursor/mcp.json

@@ -3,8 +3,8 @@
         "freeform-modeling-mcp": {
             "command": "npx",
             "args": [
-                "tsx",
-                "src/cli.ts",
+                "-y",
+                "freeform-modeling-mcp@latest",
                 "start",
                 "--stdio"
             ]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "freeform-modeling-mcp",
-  "version": "1.0.34",
+  "version": "1.0.35",
   "description": "KooMaster MCP Server with WebSocket Bridge",
   "main": "index.cjs",
   "type": "module",

package/src/tools/assets-tool.ts

@@ -73,7 +73,7 @@ export const batchSearchKjlAssetsTool = {
                 `=== Search Results for "${item.searchTerm}" ===\n${item.results}\n`
             ).join('\n');
 
-            const note = `Note about dimensions: The dimensions (x, y, z) show the model's default orientation. For example, a cabinet with larger x than y typically has its front facing the y direction and is wider along x. Consider these proportions when rotating models for proper placement. Use place_kjl_asset with the model ID to add items to your scene.`;
+            const note = `Note about dimensions: The dimensions (x, y, z) show the model's default orientation. For example, a cabinet with larger x than y typically has its front facing the y direction and is wider along x. Consider these proportions when rotating models for proper placement. Use place_kjl_asset with the obsBrandGoodId to add items to your scene.`;
 
             // context.reportProgress({
             //     progress: 100,
@@ -231,7 +231,7 @@ export const placeKjlAssetTool = {
     name: 'place_kjl_asset',
     description: 'Places a 3D model from the KJL(酷家乐) asset library into the current scene with specified position, rotation, and scale. Before placing, analyze the model\'s bounding box dimensions to determine proper orientation - elongated objects like wall panels may require 90° rotation based on intended function. Ensure bottoms align with the ground plane (z=0) by setting z-value to half the model\'s height. After placement, verify no clipping with existing objects and confirm dimensions match real-world proportions.',
     parameters: z.object({
-        modelId: z.string().describe('The unique ID of the model to place. This ID can be obtained from the batch_search_kjl_assets function results. Use the exact ID value returned by the search.'),
+        obsBrandGoodId: z.string().describe('The unique obsBrandGoodId of the model to place. Obtain it from batch_search_kjl_assets results, or from Lux3D / other kjl modeling tool output when placing a generated model. Use the exact ID value returned by the source.'),
         name: z.string().describe('Specify a name for the placed model. This name will be used for subsequent identification and reference to the model, such as when applying materials or performing transformation operations. Use descriptive names for easy identification, such as "dining_table", "office_chair", etc.'),
         originalDimensions: z.array(z.number()).describe('The original [width, height, depth] dimensions of the model as provided in the batch_search_kjl_assets results. These values must be obtained from the asset search results.'),
 
@@ -282,7 +282,7 @@ export const replaceKjlAssetTool = {
     description: 'Replaces an existing object in the scene with a new 3D model from the KJL(酷家乐) asset library. The replacement maintains the position, rotation, aligning the centers of both models. After replacement, review the scene to ensure no intersections or clipping with other objects.',
     parameters: z.object({
         targetName: z.string().describe('The name of the existing object in the scene that will be replaced. This must exactly match the name of a placed object.'),
-        newModelId: z.string().describe('The unique ID of the new model that will replace the existing object. This ID should be obtained from the batch_search_kjl_assets function results.'),
+        newBrandGoodId: z.string().describe('The unique obsBrandGoodId of the new model that will replace the existing object. Obtain it from batch_search_kjl_assets results, or from Lux3D / other kjl modeling tool output when replacing with a generated model. Use the exact ID value returned by the source.'),
         newName: z.string().describe('Specify a name for the replacement model. This name will be used for subsequent identification and reference, such as when applying materials or performing transformation operations. Use descriptive names for easy identification.'),
         originalDimensions: z.array(z.number()).describe('The original [width, height, depth] dimensions of the new model as provided in the batch_search_kjl_assets results. These values must be obtained from the asset search results.'),
         targetDimensions: z.array(z.number()).optional().describe('The target [width, height, depth] dimensions for the model after importing. These values specify the absolute size the model should be scaled to in the scene.'),

package/src/tools/import-tools.ts

@@ -40,7 +40,7 @@ function isUnsupportedModelUrl(url: string): boolean {
 
 export const importGeneratedAssetTool = {
     name: 'import_generated_asset',
-    description: 'Import a generated GLB/GLTF 3D model into the Koomaster scene from any source that provides a publicly reachable model URL. Converts GLB/GLTF to OBJ and places it asynchronously; poll with poll_import_status. Use place_kjl_asset (new import) or replace_kjl_asset (swap existing object) with modelId + assetUrl ONLY when the model is Lux3D-generated AND a modelId is available; if there is no modelId, still use this tool.',
+    description: 'Import a generated GLB/GLTF 3D model into the Koomaster scene from any source that provides a publicly reachable model URL. Converts GLB/GLTF to OBJ and places it asynchronously; poll with poll_import_status. Use place_kjl_asset (new import) with obsBrandGoodId + assetUrl, or replace_kjl_asset (swap existing object) with newBrandGoodId + assetUrl, ONLY when the model is Lux3D-generated AND an ID is available; if there is no ID, still use this tool.',
     parameters: z.object({
         name: z.string().describe('The name to give to the imported object in the scene'),
         model_url: z.string().describe('Public HTTP(S) URL of a completed GLB/GLTF model. Do not pass archive or other mesh formats such as .zip/.obj/.fbx.'),

package/src/tools/tools-info.ts

@@ -50,7 +50,7 @@ export const getToolsInfoTool = {
                     "batch_get_methods_full - Fetch full method signatures + dependency types for { interface, methods } items. Call before writing run_kds_script.",
                 ],
                 generated: [
-                    "import_generated_asset - Import a generated GLB/GLTF model from any source that provides a public model URL. Requires model_url plus name/location/dimensions.",
+                    "import_generated_asset - Import a generated GLB/GLTF 3D model into the Koomaster scene from any source that provides a publicly reachable model URL. Converts GLB/GLTF to OBJ and places it asynchronously; poll with poll_import_status. Use place_kjl_asset (new import) with obsBrandGoodId + assetUrl, or replace_kjl_asset (swap existing object) with newBrandGoodId + assetUrl, ONLY when the model is Lux3D-generated AND an ID is available; if there is no ID, still use this tool.",
                     "poll_import_status - Query GLB-to-scene import progress using the import_uuid returned by import_generated_asset."
                 ],
                 assets: [