BULC Building Designer

Instructions

Implementation Reference

• src/tools/room.ts:229-236 (handler)

  Specific handler case for 'bulc_list_rooms' tool: validates input using ListRoomsSchema and sends 'list_rooms' command to BULC client.

  case "bulc_list_rooms": {
    const validated = ListRoomsSchema.parse(args);
    result = await client.sendCommand({
      action: "list_rooms",
      params: validated,
    });
    break;
  }

• src/index.ts:69-71 (registration)

  Routing registration in main MCP server handler: dispatches all 'bulc_*_room' tools (including bulc_list_rooms) to handleRoomTool.

  if (name.startsWith("bulc_") && name.includes("room")) {
    return await handleRoomTool(name, safeArgs);
  }

• src/tools/room.ts:88-106 (schema)

  Tool definition object for 'bulc_list_rooms' including name, description, inputSchema, and annotations (part of roomTools array).

  {
    name: "bulc_list_rooms",
    description:
      "Get a list of all rooms with their IDs, names, positions, and dimensions. " +
      "Use the returned IDs for modify/delete operations.",
    inputSchema: {
      type: "object" as const,
      properties: {
        level: {
          type: "integer",
          description: "Filter by floor level index. Omit to list all rooms.",
        },
      },
    },
    annotations: {
      readOnlyHint: true,
      destructiveHint: false,
    },
  },

• src/tools/room.ts:183-185 (schema)

  Zod schema for input validation of 'bulc_list_rooms' parameters.

  const ListRoomsSchema = z.object({
    level: z.number().int().optional(),
  });

• src/index.ts:40-51 (registration)

  Inclusion of roomTools (containing bulc_list_rooms schema) in the allTools array, used for listing available tools in MCP server.

  const allTools = [
    ...contextTools,      // 8 tools: spatial context, home info, levels, undo/redo, save
    ...roomTools,         // 5 tools: create, create_polygon, list, modify, delete
    ...wallTools,         // 5 tools: create, create_rectangle, list, modify, delete
    ...furnitureTools,    // 5 tools: catalog, place, list, modify, delete
    ...fdsDataTools,      // 7 tools: get, fire_source, detector, sprinkler, hvac, thermocouple, clear
    ...meshTools,         // 5 tools: list, create, auto, modify, delete
    ...simulationTools,   // 4 tools: get_settings, time, output, ambient
    ...fdsRunTools,       // 6 tools: preview, validate, export, run, status, stop
    ...resultTools,       // 5 tools: open_viewer, list_datasets, point_data, aset, report
    ...evacTools,         // 25 tools: setup, stairs, agents, run, results, advanced features
  ];