BULC Building Designer

Instructions

Implementation Reference

• src/tools/evac.ts:989-996 (handler)

  Handler implementation for the 'bulc_run_evac' tool. It parses the input arguments using RunEvacSchema and sends the 'run_evac' action command to the BULC client via getBulcClient().

  case "bulc_run_evac": {
    const validated = RunEvacSchema.parse(args);
    result = await client.sendCommand({
      action: "run_evac",
      params: validated,
    });
    break;
  }

• src/tools/evac.ts:342-360 (schema)

  Tool definition object for 'bulc_run_evac' exported in evacTools array, including name, description, inputSchema for MCP tool discovery and validation.

  {
    name: "bulc_run_evac",
    description:
      "Start evacuation simulation using JuPedSim. " +
      "Returns immediately; use bulc_get_evac_status to monitor progress.",
    inputSchema: {
      type: "object" as const,
      properties: {
        multiLevel: {
          type: "boolean",
          description: "Use multi-level simulation with stairs. Default: auto-detect",
        },
      },
    },
    annotations: {
      readOnlyHint: false,
      destructiveHint: true,
    },
  },

• src/tools/evac.ts:797-799 (schema)

  Zod schema used for runtime input validation in the handler for 'bulc_run_evac'.

  const RunEvacSchema = z.object({
    multiLevel: z.boolean().optional(),
  });

• src/index.ts:54-58 (registration)

  MCP server registration of all tools (including 'bulc_run_evac' via evacTools spread into allTools) for the ListToolsRequest.

  server.setRequestHandler(ListToolsRequestSchema, async () => {
    return {
      tools: allTools,
    };
  });

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

  Routing logic in main MCP CallToolRequestHandler that dispatches 'bulc_run_evac' (and other evac tools) to the handleEvacTool function.

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