unreal-engine-mcp-server 0.3.1 → 0.4.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (144) hide show
  1. package/.env.production +1 -1
  2. package/.github/copilot-instructions.md +45 -0
  3. package/.github/workflows/publish-mcp.yml +1 -1
  4. package/README.md +22 -7
  5. package/dist/index.js +137 -46
  6. package/dist/prompts/index.d.ts +10 -3
  7. package/dist/prompts/index.js +186 -7
  8. package/dist/resources/actors.d.ts +19 -1
  9. package/dist/resources/actors.js +55 -64
  10. package/dist/resources/assets.d.ts +3 -2
  11. package/dist/resources/assets.js +117 -109
  12. package/dist/resources/levels.d.ts +21 -3
  13. package/dist/resources/levels.js +31 -56
  14. package/dist/tools/actors.d.ts +3 -14
  15. package/dist/tools/actors.js +246 -302
  16. package/dist/tools/animation.d.ts +57 -102
  17. package/dist/tools/animation.js +429 -450
  18. package/dist/tools/assets.d.ts +13 -2
  19. package/dist/tools/assets.js +58 -46
  20. package/dist/tools/audio.d.ts +22 -13
  21. package/dist/tools/audio.js +467 -121
  22. package/dist/tools/blueprint.d.ts +32 -13
  23. package/dist/tools/blueprint.js +699 -448
  24. package/dist/tools/build_environment_advanced.d.ts +0 -1
  25. package/dist/tools/build_environment_advanced.js +236 -87
  26. package/dist/tools/consolidated-tool-definitions.d.ts +232 -15
  27. package/dist/tools/consolidated-tool-definitions.js +124 -255
  28. package/dist/tools/consolidated-tool-handlers.js +749 -766
  29. package/dist/tools/debug.d.ts +72 -10
  30. package/dist/tools/debug.js +170 -36
  31. package/dist/tools/editor.d.ts +9 -2
  32. package/dist/tools/editor.js +30 -44
  33. package/dist/tools/foliage.d.ts +34 -15
  34. package/dist/tools/foliage.js +97 -107
  35. package/dist/tools/introspection.js +19 -21
  36. package/dist/tools/landscape.d.ts +1 -2
  37. package/dist/tools/landscape.js +311 -168
  38. package/dist/tools/level.d.ts +3 -28
  39. package/dist/tools/level.js +642 -192
  40. package/dist/tools/lighting.d.ts +14 -3
  41. package/dist/tools/lighting.js +236 -123
  42. package/dist/tools/materials.d.ts +25 -7
  43. package/dist/tools/materials.js +102 -79
  44. package/dist/tools/niagara.d.ts +10 -12
  45. package/dist/tools/niagara.js +74 -94
  46. package/dist/tools/performance.d.ts +12 -4
  47. package/dist/tools/performance.js +38 -79
  48. package/dist/tools/physics.d.ts +34 -10
  49. package/dist/tools/physics.js +364 -292
  50. package/dist/tools/rc.js +98 -24
  51. package/dist/tools/sequence.d.ts +1 -0
  52. package/dist/tools/sequence.js +146 -24
  53. package/dist/tools/ui.d.ts +31 -4
  54. package/dist/tools/ui.js +83 -66
  55. package/dist/tools/visual.d.ts +11 -0
  56. package/dist/tools/visual.js +245 -30
  57. package/dist/types/tool-types.d.ts +0 -6
  58. package/dist/types/tool-types.js +1 -8
  59. package/dist/unreal-bridge.d.ts +32 -2
  60. package/dist/unreal-bridge.js +621 -127
  61. package/dist/utils/elicitation.d.ts +57 -0
  62. package/dist/utils/elicitation.js +104 -0
  63. package/dist/utils/error-handler.d.ts +0 -33
  64. package/dist/utils/error-handler.js +4 -111
  65. package/dist/utils/http.d.ts +2 -22
  66. package/dist/utils/http.js +12 -75
  67. package/dist/utils/normalize.d.ts +4 -4
  68. package/dist/utils/normalize.js +15 -7
  69. package/dist/utils/python-output.d.ts +18 -0
  70. package/dist/utils/python-output.js +290 -0
  71. package/dist/utils/python.d.ts +2 -0
  72. package/dist/utils/python.js +4 -0
  73. package/dist/utils/response-validator.d.ts +6 -1
  74. package/dist/utils/response-validator.js +66 -13
  75. package/dist/utils/result-helpers.d.ts +27 -0
  76. package/dist/utils/result-helpers.js +147 -0
  77. package/dist/utils/safe-json.d.ts +0 -2
  78. package/dist/utils/safe-json.js +0 -43
  79. package/dist/utils/validation.d.ts +16 -0
  80. package/dist/utils/validation.js +70 -7
  81. package/mcp-config-example.json +2 -2
  82. package/package.json +11 -10
  83. package/server.json +37 -14
  84. package/src/index.ts +146 -50
  85. package/src/prompts/index.ts +211 -13
  86. package/src/resources/actors.ts +59 -44
  87. package/src/resources/assets.ts +123 -102
  88. package/src/resources/levels.ts +37 -47
  89. package/src/tools/actors.ts +269 -313
  90. package/src/tools/animation.ts +556 -539
  91. package/src/tools/assets.ts +59 -45
  92. package/src/tools/audio.ts +507 -113
  93. package/src/tools/blueprint.ts +778 -462
  94. package/src/tools/build_environment_advanced.ts +312 -106
  95. package/src/tools/consolidated-tool-definitions.ts +136 -267
  96. package/src/tools/consolidated-tool-handlers.ts +871 -795
  97. package/src/tools/debug.ts +179 -38
  98. package/src/tools/editor.ts +35 -37
  99. package/src/tools/foliage.ts +110 -104
  100. package/src/tools/introspection.ts +24 -22
  101. package/src/tools/landscape.ts +334 -181
  102. package/src/tools/level.ts +683 -182
  103. package/src/tools/lighting.ts +244 -123
  104. package/src/tools/materials.ts +114 -83
  105. package/src/tools/niagara.ts +87 -81
  106. package/src/tools/performance.ts +49 -88
  107. package/src/tools/physics.ts +393 -299
  108. package/src/tools/rc.ts +103 -25
  109. package/src/tools/sequence.ts +157 -30
  110. package/src/tools/ui.ts +101 -70
  111. package/src/tools/visual.ts +250 -29
  112. package/src/types/tool-types.ts +0 -9
  113. package/src/unreal-bridge.ts +658 -140
  114. package/src/utils/elicitation.ts +129 -0
  115. package/src/utils/error-handler.ts +4 -159
  116. package/src/utils/http.ts +16 -115
  117. package/src/utils/normalize.ts +20 -10
  118. package/src/utils/python-output.ts +351 -0
  119. package/src/utils/python.ts +3 -0
  120. package/src/utils/response-validator.ts +68 -17
  121. package/src/utils/result-helpers.ts +193 -0
  122. package/src/utils/safe-json.ts +0 -50
  123. package/src/utils/validation.ts +94 -7
  124. package/tests/run-unreal-tool-tests.mjs +720 -0
  125. package/tsconfig.json +2 -2
  126. package/dist/python-utils.d.ts +0 -29
  127. package/dist/python-utils.js +0 -54
  128. package/dist/tools/tool-definitions.d.ts +0 -4919
  129. package/dist/tools/tool-definitions.js +0 -1065
  130. package/dist/tools/tool-handlers.d.ts +0 -47
  131. package/dist/tools/tool-handlers.js +0 -863
  132. package/dist/types/index.d.ts +0 -323
  133. package/dist/types/index.js +0 -28
  134. package/dist/utils/cache-manager.d.ts +0 -64
  135. package/dist/utils/cache-manager.js +0 -176
  136. package/dist/utils/errors.d.ts +0 -133
  137. package/dist/utils/errors.js +0 -256
  138. package/src/python/editor_compat.py +0 -181
  139. package/src/python-utils.ts +0 -57
  140. package/src/tools/tool-definitions.ts +0 -1081
  141. package/src/tools/tool-handlers.ts +0 -973
  142. package/src/types/index.ts +0 -414
  143. package/src/utils/cache-manager.ts +0 -213
  144. package/src/utils/errors.ts +0 -312
package/dist/tools/consolidated-tool-definitions.d.ts CHANGED
@@ -63,8 +63,15 @@ export declare const consolidatedToolDefinitions: ({
63
63
  sizeX?: undefined;
64
64
  sizeY?: undefined;
65
65
  tool?: undefined;
66
- meshPath?: undefined;
66
+ subdivisions?: undefined;
67
+ heightFunction?: undefined;
68
+ materialPath?: undefined;
69
+ bounds?: undefined;
70
+ foliageTypes?: undefined;
71
+ seed?: undefined;
67
72
  foliageType?: undefined;
73
+ transforms?: undefined;
74
+ meshPath?: undefined;
68
75
  density?: undefined;
69
76
  position?: undefined;
70
77
  brushSize?: undefined;
@@ -294,8 +301,15 @@ export declare const consolidatedToolDefinitions: ({
294
301
  sizeX?: undefined;
295
302
  sizeY?: undefined;
296
303
  tool?: undefined;
297
- meshPath?: undefined;
304
+ subdivisions?: undefined;
305
+ heightFunction?: undefined;
306
+ materialPath?: undefined;
307
+ bounds?: undefined;
308
+ foliageTypes?: undefined;
309
+ seed?: undefined;
298
310
  foliageType?: undefined;
311
+ transforms?: undefined;
312
+ meshPath?: undefined;
299
313
  density?: undefined;
300
314
  position?: undefined;
301
315
  brushSize?: undefined;
@@ -489,8 +503,15 @@ export declare const consolidatedToolDefinitions: ({
489
503
  sizeX?: undefined;
490
504
  sizeY?: undefined;
491
505
  tool?: undefined;
492
- meshPath?: undefined;
506
+ subdivisions?: undefined;
507
+ heightFunction?: undefined;
508
+ materialPath?: undefined;
509
+ bounds?: undefined;
510
+ foliageTypes?: undefined;
511
+ seed?: undefined;
493
512
  foliageType?: undefined;
513
+ transforms?: undefined;
514
+ meshPath?: undefined;
494
515
  density?: undefined;
495
516
  position?: undefined;
496
517
  brushSize?: undefined;
@@ -703,8 +724,15 @@ export declare const consolidatedToolDefinitions: ({
703
724
  sizeX?: undefined;
704
725
  sizeY?: undefined;
705
726
  tool?: undefined;
706
- meshPath?: undefined;
727
+ subdivisions?: undefined;
728
+ heightFunction?: undefined;
729
+ materialPath?: undefined;
730
+ bounds?: undefined;
731
+ foliageTypes?: undefined;
732
+ seed?: undefined;
707
733
  foliageType?: undefined;
734
+ transforms?: undefined;
735
+ meshPath?: undefined;
708
736
  density?: undefined;
709
737
  position?: undefined;
710
738
  brushSize?: undefined;
@@ -899,8 +927,15 @@ export declare const consolidatedToolDefinitions: ({
899
927
  sizeX?: undefined;
900
928
  sizeY?: undefined;
901
929
  tool?: undefined;
902
- meshPath?: undefined;
930
+ subdivisions?: undefined;
931
+ heightFunction?: undefined;
932
+ materialPath?: undefined;
933
+ bounds?: undefined;
934
+ foliageTypes?: undefined;
935
+ seed?: undefined;
903
936
  foliageType?: undefined;
937
+ transforms?: undefined;
938
+ meshPath?: undefined;
904
939
  density?: undefined;
905
940
  position?: undefined;
906
941
  brushSize?: undefined;
@@ -1105,8 +1140,15 @@ export declare const consolidatedToolDefinitions: ({
1105
1140
  sizeX?: undefined;
1106
1141
  sizeY?: undefined;
1107
1142
  tool?: undefined;
1108
- meshPath?: undefined;
1143
+ subdivisions?: undefined;
1144
+ heightFunction?: undefined;
1145
+ materialPath?: undefined;
1146
+ bounds?: undefined;
1147
+ foliageTypes?: undefined;
1148
+ seed?: undefined;
1109
1149
  foliageType?: undefined;
1150
+ transforms?: undefined;
1151
+ meshPath?: undefined;
1110
1152
  density?: undefined;
1111
1153
  position?: undefined;
1112
1154
  brushSize?: undefined;
@@ -1289,8 +1331,15 @@ export declare const consolidatedToolDefinitions: ({
1289
1331
  sizeX?: undefined;
1290
1332
  sizeY?: undefined;
1291
1333
  tool?: undefined;
1292
- meshPath?: undefined;
1334
+ subdivisions?: undefined;
1335
+ heightFunction?: undefined;
1336
+ materialPath?: undefined;
1337
+ bounds?: undefined;
1338
+ foliageTypes?: undefined;
1339
+ seed?: undefined;
1293
1340
  foliageType?: undefined;
1341
+ transforms?: undefined;
1342
+ meshPath?: undefined;
1294
1343
  density?: undefined;
1295
1344
  position?: undefined;
1296
1345
  brushSize?: undefined;
@@ -1429,12 +1478,146 @@ export declare const consolidatedToolDefinitions: ({
1429
1478
  type: string;
1430
1479
  description: string;
1431
1480
  };
1432
- meshPath: {
1481
+ location: {
1482
+ type: string;
1483
+ properties: {
1484
+ x: {
1485
+ type: string;
1486
+ };
1487
+ y: {
1488
+ type: string;
1489
+ };
1490
+ z: {
1491
+ type: string;
1492
+ };
1493
+ };
1494
+ };
1495
+ subdivisions: {
1496
+ type: string;
1497
+ };
1498
+ heightFunction: {
1499
+ type: string;
1500
+ };
1501
+ materialPath: {
1502
+ type: string;
1503
+ };
1504
+ bounds: {
1505
+ type: string;
1506
+ properties: {
1507
+ location: {
1508
+ type: string;
1509
+ properties: {
1510
+ x: {
1511
+ type: string;
1512
+ };
1513
+ y: {
1514
+ type: string;
1515
+ };
1516
+ z: {
1517
+ type: string;
1518
+ };
1519
+ };
1520
+ };
1521
+ size: {
1522
+ type: string;
1523
+ properties: {
1524
+ x: {
1525
+ type: string;
1526
+ };
1527
+ y: {
1528
+ type: string;
1529
+ };
1530
+ z: {
1531
+ type: string;
1532
+ };
1533
+ };
1534
+ };
1535
+ };
1536
+ };
1537
+ foliageTypes: {
1538
+ type: string;
1539
+ items: {
1540
+ type: string;
1541
+ properties: {
1542
+ meshPath: {
1543
+ type: string;
1544
+ };
1545
+ density: {
1546
+ type: string;
1547
+ };
1548
+ minScale: {
1549
+ type: string;
1550
+ };
1551
+ maxScale: {
1552
+ type: string;
1553
+ };
1554
+ alignToNormal: {
1555
+ type: string;
1556
+ };
1557
+ randomYaw: {
1558
+ type: string;
1559
+ };
1560
+ };
1561
+ };
1562
+ };
1563
+ seed: {
1433
1564
  type: string;
1434
- description: string;
1435
1565
  };
1436
1566
  foliageType: {
1437
1567
  type: string;
1568
+ };
1569
+ transforms: {
1570
+ type: string;
1571
+ items: {
1572
+ type: string;
1573
+ properties: {
1574
+ location: {
1575
+ type: string;
1576
+ properties: {
1577
+ x: {
1578
+ type: string;
1579
+ };
1580
+ y: {
1581
+ type: string;
1582
+ };
1583
+ z: {
1584
+ type: string;
1585
+ };
1586
+ };
1587
+ };
1588
+ rotation: {
1589
+ type: string;
1590
+ properties: {
1591
+ pitch: {
1592
+ type: string;
1593
+ };
1594
+ yaw: {
1595
+ type: string;
1596
+ };
1597
+ roll: {
1598
+ type: string;
1599
+ };
1600
+ };
1601
+ };
1602
+ scale: {
1603
+ type: string;
1604
+ properties: {
1605
+ x: {
1606
+ type: string;
1607
+ };
1608
+ y: {
1609
+ type: string;
1610
+ };
1611
+ z: {
1612
+ type: string;
1613
+ };
1614
+ };
1615
+ };
1616
+ };
1617
+ };
1618
+ };
1619
+ meshPath: {
1620
+ type: string;
1438
1621
  description: string;
1439
1622
  };
1440
1623
  density: {
@@ -1469,7 +1652,6 @@ export declare const consolidatedToolDefinitions: ({
1469
1652
  path?: undefined;
1470
1653
  actorName?: undefined;
1471
1654
  classPath?: undefined;
1472
- location?: undefined;
1473
1655
  rotation?: undefined;
1474
1656
  force?: undefined;
1475
1657
  viewMode?: undefined;
@@ -1724,8 +1906,15 @@ export declare const consolidatedToolDefinitions: ({
1724
1906
  sizeX?: undefined;
1725
1907
  sizeY?: undefined;
1726
1908
  tool?: undefined;
1727
- meshPath?: undefined;
1909
+ subdivisions?: undefined;
1910
+ heightFunction?: undefined;
1911
+ materialPath?: undefined;
1912
+ bounds?: undefined;
1913
+ foliageTypes?: undefined;
1914
+ seed?: undefined;
1728
1915
  foliageType?: undefined;
1916
+ transforms?: undefined;
1917
+ meshPath?: undefined;
1729
1918
  density?: undefined;
1730
1919
  position?: undefined;
1731
1920
  brushSize?: undefined;
@@ -1894,8 +2083,15 @@ export declare const consolidatedToolDefinitions: ({
1894
2083
  sizeX?: undefined;
1895
2084
  sizeY?: undefined;
1896
2085
  tool?: undefined;
1897
- meshPath?: undefined;
2086
+ subdivisions?: undefined;
2087
+ heightFunction?: undefined;
2088
+ materialPath?: undefined;
2089
+ bounds?: undefined;
2090
+ foliageTypes?: undefined;
2091
+ seed?: undefined;
1898
2092
  foliageType?: undefined;
2093
+ transforms?: undefined;
2094
+ meshPath?: undefined;
1899
2095
  density?: undefined;
1900
2096
  position?: undefined;
1901
2097
  brushSize?: undefined;
@@ -2083,8 +2279,15 @@ export declare const consolidatedToolDefinitions: ({
2083
2279
  sizeX?: undefined;
2084
2280
  sizeY?: undefined;
2085
2281
  tool?: undefined;
2086
- meshPath?: undefined;
2282
+ subdivisions?: undefined;
2283
+ heightFunction?: undefined;
2284
+ materialPath?: undefined;
2285
+ bounds?: undefined;
2286
+ foliageTypes?: undefined;
2287
+ seed?: undefined;
2087
2288
  foliageType?: undefined;
2289
+ transforms?: undefined;
2290
+ meshPath?: undefined;
2088
2291
  density?: undefined;
2089
2292
  position?: undefined;
2090
2293
  brushSize?: undefined;
@@ -2292,8 +2495,15 @@ export declare const consolidatedToolDefinitions: ({
2292
2495
  sizeX?: undefined;
2293
2496
  sizeY?: undefined;
2294
2497
  tool?: undefined;
2295
- meshPath?: undefined;
2498
+ subdivisions?: undefined;
2499
+ heightFunction?: undefined;
2500
+ materialPath?: undefined;
2501
+ bounds?: undefined;
2502
+ foliageTypes?: undefined;
2503
+ seed?: undefined;
2296
2504
  foliageType?: undefined;
2505
+ transforms?: undefined;
2506
+ meshPath?: undefined;
2297
2507
  density?: undefined;
2298
2508
  position?: undefined;
2299
2509
  brushSize?: undefined;
@@ -2487,8 +2697,15 @@ export declare const consolidatedToolDefinitions: ({
2487
2697
  sizeX?: undefined;
2488
2698
  sizeY?: undefined;
2489
2699
  tool?: undefined;
2490
- meshPath?: undefined;
2700
+ subdivisions?: undefined;
2701
+ heightFunction?: undefined;
2702
+ materialPath?: undefined;
2703
+ bounds?: undefined;
2704
+ foliageTypes?: undefined;
2705
+ seed?: undefined;
2491
2706
  foliageType?: undefined;
2707
+ transforms?: undefined;
2708
+ meshPath?: undefined;
2492
2709
  density?: undefined;
2493
2710
  position?: undefined;
2494
2711
  brushSize?: undefined;