sbox-mcp-server 1.2.0 → 1.3.0

package/dist/index.js

@@ -17,7 +17,6 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 import { BridgeClient } from "./transport/bridge-client.js";
 import { registerProjectTools } from "./tools/project.js";
 import { registerScriptTools } from "./tools/scripts.js";
-import { registerConsoleTools } from "./tools/console.js";
 import { registerSceneTools } from "./tools/scenes.js";
 import { registerGameObjectTools } from "./tools/gameobjects.js";
 import { registerComponentTools } from "./tools/components.js";
@@ -67,18 +66,17 @@ ENVIRONMENT VARIABLES
 CONNECT TO CLAUDE CODE
   claude mcp add sbox -- node /path/to/sbox-mcp-server/dist/index.js
 
-TOOLS (109 total)
+TOOLS (99 working — was 109; 10 unimplementable tools removed in v1.3.0)
   Project:     get_project_info, list_project_files, read_file, write_file
   Scripts:     create_script, edit_script, delete_script, trigger_hotload
-  Console:     get_console_output, get_compile_errors, clear_console
   Scenes:      list_scenes, load_scene, save_scene, create_scene
   GameObjects: create/delete/duplicate/rename_gameobject, set_parent/enabled/transform
   Components:  get/set_property, get_all_properties, list_available_components, add_component_with_properties, set_prefab_ref
-  Hierarchy:   get_scene_hierarchy, get_selected_objects, select_object, focus_object
+  Hierarchy:   get_scene_hierarchy (with maxDepth + rootId), get_selected_objects, select_object, focus_object
   Assets:      search_assets, list_asset_library, install_asset, get_asset_info
   Materials:   assign_model, create_material, assign_material, set_material_property
   Audio:       list_sounds, create_sound_event, assign_sound, play_sound_preview
-  Play Mode:   start/stop/pause/resume_play, is_playing
+  Play Mode:   start_play, stop_play, is_playing
   Runtime:     get/set_runtime_property, take_screenshot
   Editor:      undo, redo
   Prefabs:     create_prefab, instantiate_prefab, list_prefabs, get_prefab_info
@@ -87,8 +85,7 @@ TOOLS (109 total)
   Templates:   create_player_controller, create_npc_controller, create_game_manager, create_trigger_zone
   Networking:  add_network_helper, configure_network, get_network_status, network_spawn, set_ownership
   Net Scripts: add_sync_property, add_rpc_method, create_networked_player, create_lobby_manager, create_network_events
-  Publishing:  get_project_config, set_project_config, validate_project, build_project, get_build_status, clean_build
-  Export:      export_project, set_project_thumbnail, get_package_details, prepare_publish
+  Publishing:  get_project_config, set_project_config, validate_project, set_project_thumbnail, get_package_details
   World Gen:   invoke_button, list_component_buttons, raycast_terrain, build_terrain_mesh
   Map Edit:    add_terrain_hill/clearing/trail, clear_terrain_features, sculpt_terrain
   Caves:       add_cave_waypoint, clear_cave_path
@@ -109,7 +106,6 @@ const bridge = new BridgeClient(process.env.SBOX_BRIDGE_HOST ?? "127.0.0.1", par
 // Register all tools
 registerProjectTools(server, bridge);
 registerScriptTools(server, bridge);
-registerConsoleTools(server, bridge);
 registerSceneTools(server, bridge);
 registerGameObjectTools(server, bridge);
 registerComponentTools(server, bridge);

package/dist/tools/gameobjects.js

@@ -141,11 +141,17 @@ export function registerGameObjectTools(server, bridge) {
         };
     });
     // ── get_scene_hierarchy ──────────────────────────────────────────
-    server.tool("get_scene_hierarchy", "Get the full scene tree — all GameObjects with their names, GUIDs, components, positions, and parent/child relationships. This is how you 'see' the scene", {
+    server.tool("get_scene_hierarchy", "Get the scene tree — GameObjects with their names, GUIDs, components, and parent/child relationships. Pair maxDepth with rootId to drill into a subtree without paying for the whole scene", {
         maxDepth: z
             .number()
+            .int()
+            .nonnegative()
             .optional()
-            .describe("Maximum depth of the tree to return. Defaults to 10"),
+            .describe("Maximum recursion depth. Defaults to 10. Use 1 or 2 for cheap top-level overviews"),
+        rootId: z
+            .string()
+            .optional()
+            .describe("Optional GUID of a GameObject to start traversal from. Omit to walk from the scene roots"),
     }, async (params) => {
         const res = await bridge.send("get_scene_hierarchy", params);
         if (!res.success) {

package/dist/tools/playmode.js

@@ -27,26 +27,9 @@ export function registerPlayModeTools(server, bridge) {
             content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }],
         };
     });
-    // ── pause_play ───────────────────────────────────────────────────
-    server.tool("pause_play", "Pause the running game — freezes simulation but stays in play mode. Use resume_play to continue", {}, async () => {
-        const res = await bridge.send("pause_play");
-        if (!res.success) {
-            return { content: [{ type: "text", text: `Error: ${res.error}` }] };
-        }
-        return {
-            content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }],
-        };
-    });
-    // ── resume_play ──────────────────────────────────────────────────
-    server.tool("resume_play", "Resume a paused game — unfreezes simulation", {}, async () => {
-        const res = await bridge.send("resume_play");
-        if (!res.success) {
-            return { content: [{ type: "text", text: `Error: ${res.error}` }] };
-        }
-        return {
-            content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }],
-        };
-    });
+    // pause_play / resume_play removed in v1.3.0 — s&box does not expose a public
+    // API for pausing the editor's play mode, so the addon has no handler and the
+    // tool only ever returned "Unknown command". See GitHub issue #3.
     // ── is_playing ───────────────────────────────────────────────────
     server.tool("is_playing", "Check current play state — returns 'playing', 'paused', or 'stopped'", {}, async () => {
         const res = await bridge.send("is_playing");

package/dist/tools/publishing.d.ts

@@ -2,10 +2,14 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { BridgeClient } from "../transport/bridge-client.js";
 /**
  * Publishing tools: get_project_config, set_project_config, validate_project,
- * build_project, get_build_status, clean_build, export_project,
- * set_project_thumbnail, get_package_details, prepare_publish.
+ * set_project_thumbnail, get_package_details.
  *
- * Manages project configuration, building, exporting, and publishing preparation.
+ * Manages project configuration and publishing metadata.
+ *
+ * build_project / get_build_status / clean_build / export_project / prepare_publish
+ * were removed in v1.3.0 — s&box does not expose a public API for these from
+ * inside an addon, so the bridge never had handlers for them and the tools only
+ * ever returned "Unknown command". See GitHub issue #3.
  */
 export declare function registerPublishingTools(server: McpServer, bridge: BridgeClient): void;
 //# sourceMappingURL=publishing.d.ts.map

package/dist/tools/publishing.js

@@ -1,10 +1,14 @@
 import { z } from "zod";
 /**
  * Publishing tools: get_project_config, set_project_config, validate_project,
- * build_project, get_build_status, clean_build, export_project,
- * set_project_thumbnail, get_package_details, prepare_publish.
+ * set_project_thumbnail, get_package_details.
  *
- * Manages project configuration, building, exporting, and publishing preparation.
+ * Manages project configuration and publishing metadata.
+ *
+ * build_project / get_build_status / clean_build / export_project / prepare_publish
+ * were removed in v1.3.0 — s&box does not expose a public API for these from
+ * inside an addon, so the bridge never had handlers for them and the tools only
+ * ever returned "Unknown command". See GitHub issue #3.
  */
 export function registerPublishingTools(server, bridge) {
     // ── get_project_config ───────────────────────────────────────────
@@ -63,60 +67,8 @@ export function registerPublishingTools(server, bridge) {
             content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }],
         };
     });
-    // ── build_project ────────────────────────────────────────────────
-    server.tool("build_project", "Trigger a full project build/recompilation. Returns build result with error and warning counts", {
-        configuration: z
-            .enum(["Debug", "Release"])
-            .optional()
-            .describe("Build configuration. Defaults to 'Release'"),
-    }, async (params) => {
-        const res = await bridge.send("build_project", params);
-        if (!res.success) {
-            return { content: [{ type: "text", text: `Error: ${res.error}` }] };
-        }
-        return {
-            content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }],
-        };
-    });
-    // ── get_build_status ─────────────────────────────────────────────
-    server.tool("get_build_status", "Get the current build/compilation status: is compiling, errors, warnings, and full diagnostics list", {}, async (params) => {
-        const res = await bridge.send("get_build_status", params);
-        if (!res.success) {
-            return { content: [{ type: "text", text: `Error: ${res.error}` }] };
-        }
-        return {
-            content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }],
-        };
-    });
-    // ── clean_build ──────────────────────────────────────────────────
-    server.tool("clean_build", "Clean all compiled output (bin, obj) and trigger a fresh rebuild from scratch", {}, async (params) => {
-        const res = await bridge.send("clean_build", params);
-        if (!res.success) {
-            return { content: [{ type: "text", text: `Error: ${res.error}` }] };
-        }
-        return {
-            content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }],
-        };
-    });
-    // ── export_project ───────────────────────────────────────────────
-    server.tool("export_project", "Export the project as a standalone game. Copies assemblies, assets, and scenes to an output directory for distribution", {
-        outputPath: z
-            .string()
-            .optional()
-            .describe("Relative output directory within the project. Defaults to 'export'"),
-        configuration: z
-            .enum(["Debug", "Release"])
-            .optional()
-            .describe("Build configuration for export. Defaults to 'Release'"),
-    }, async (params) => {
-        const res = await bridge.send("export_project", params);
-        if (!res.success) {
-            return { content: [{ type: "text", text: `Error: ${res.error}` }] };
-        }
-        return {
-            content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }],
-        };
-    });
+    // build_project / get_build_status / clean_build / export_project removed
+    // in v1.3.0 — no addon handler exists. See GitHub issue #3.
     // ── set_project_thumbnail ────────────────────────────────────────
     server.tool("set_project_thumbnail", "Set or update the project thumbnail image (thumb.png) used for publishing. Provide either a source path or base64 image data", {
         sourcePath: z
@@ -154,15 +106,7 @@ export function registerPublishingTools(server, bridge) {
             content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }],
         };
     });
-    // ── prepare_publish ──────────────────────────────────────────────
-    server.tool("prepare_publish", "Comprehensive publish preparation: validates project, compiles, checks metadata, and generates a detailed readiness report with issues, warnings, and next steps", {}, async (params) => {
-        const res = await bridge.send("prepare_publish", params);
-        if (!res.success) {
-            return { content: [{ type: "text", text: `Error: ${res.error}` }] };
-        }
-        return {
-            content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }],
-        };
-    });
+    // prepare_publish removed in v1.3.0 — no addon handler. Equivalent intent is
+    // covered by validate_project (which IS implemented). GitHub issue #3.
 }
 //# sourceMappingURL=publishing.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sbox-mcp-server",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "MCP Server for s&box game engine — enables Claude to build games through conversation",
   "type": "module",
   "main": "dist/index.js",