freeform-modeling-mcp 1.0.30 → 1.0.32

package/.cursor/mcp.json

@@ -7,8 +7,7 @@
                 "src/cli.ts",
                 "start",
                 "--stdio"
-            ],
-            "cwd": "D:\\wain\\mcp-server"
+            ]
         },
         "aholo-sdk-mcp": {
             "type": "stdio",

package/package.json

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

package/src/tools/assets-tool.ts

@@ -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.number().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.'),
+        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.'),
         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.'),
 
@@ -239,6 +239,7 @@ export const placeKjlAssetTool = {
         location: z.array(z.number()).describe('[x, y, z] center position coordinates for the imported model'),
         targetDimensions: z.array(z.number()).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.'),
         rotation: z.array(z.number()).optional().describe('Optional [x, y, z] rotation in degrees. Following the Z-up coordinate system: rotation around X-axis tilts the object left/right (like nodding sideways), rotation around Y-axis tilts the object forward/backward (like nodding), and rotation around Z-axis rotates the object in the horizontal plane (like spinning on the ground). Positive values follow the right-hand rule: point thumb in positive axis direction, fingers show positive rotation direction.'),
+        assetUrl: z.string().optional().describe('Optional GLB URL of the asset. Required when placing a Lux3d-generated model; omit for regular KJL catalog assets.'),
     }),
     execute: async (args, context: Context): Promise<ContentResult> => {
         try {
@@ -281,10 +282,11 @@ 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.number().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.'),
+        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.'),
         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.'),
+        assetUrl: z.string().optional().describe('Optional GLB URL of the asset. Required when placing a Lux3d-generated model; omit for regular KJL catalog assets.'),
     }),
     execute: async (args, context: Context): Promise<ContentResult> => {
         try {

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.',
+    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.',
     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.'),