BULC Building Designer

Instructions

Implementation Reference

• src/tools/evac.ts:1014-1021 (handler)

  Handler implementation for the bulc_load_evac_result tool. Validates input using LoadEvacResultSchema and forwards the 'load_evac_result' command to the BULC client via getBulcClient().

  case "bulc_load_evac_result": {
    const validated = LoadEvacResultSchema.parse(args);
    result = await client.sendCommand({
      action: "load_evac_result",
      params: validated,
    });
    break;
  }

• src/tools/evac.ts:801-803 (schema)

  Zod schema defining the input validation for bulc_load_evac_result tool: optional 'evacPath' string parameter.

  const LoadEvacResultSchema = z.object({
    evacPath: z.string().optional(),
  });

• src/tools/evac.ts:388-405 (registration)

  MCP tool registration object for bulc_load_evac_result, including name, description, input schema, and annotations. This object is part of the exported evacTools array used in the main server.

  {
    name: "bulc_load_evac_result",
    description:
      "Load evacuation results from a .evac file for visualization.",
    inputSchema: {
      type: "object" as const,
      properties: {
        evacPath: {
          type: "string",
          description: "Path to .evac file. Default: auto-detect from last simulation",
        },
      },
    },
    annotations: {
      readOnlyHint: false,
      destructiveHint: false,
    },
  },

• src/index.ts:135-137 (handler)

  Top-level tool dispatch handler in main MCP server that routes bulc_load_evac_result (and other evac tools) to the specific handleEvacTool function.

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