unreal-engine-mcp-server 0.2.1

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 (155) hide show
  1. package/.dockerignore +57 -0
  2. package/.env.production +25 -0
  3. package/.eslintrc.json +54 -0
  4. package/.github/workflows/publish-mcp.yml +75 -0
  5. package/Dockerfile +54 -0
  6. package/LICENSE +21 -0
  7. package/Public/icon.png +0 -0
  8. package/README.md +209 -0
  9. package/claude_desktop_config_example.json +13 -0
  10. package/dist/cli.d.ts +3 -0
  11. package/dist/cli.js +7 -0
  12. package/dist/index.d.ts +31 -0
  13. package/dist/index.js +484 -0
  14. package/dist/prompts/index.d.ts +14 -0
  15. package/dist/prompts/index.js +38 -0
  16. package/dist/python-utils.d.ts +29 -0
  17. package/dist/python-utils.js +54 -0
  18. package/dist/resources/actors.d.ts +13 -0
  19. package/dist/resources/actors.js +83 -0
  20. package/dist/resources/assets.d.ts +23 -0
  21. package/dist/resources/assets.js +245 -0
  22. package/dist/resources/levels.d.ts +17 -0
  23. package/dist/resources/levels.js +94 -0
  24. package/dist/tools/actors.d.ts +51 -0
  25. package/dist/tools/actors.js +459 -0
  26. package/dist/tools/animation.d.ts +196 -0
  27. package/dist/tools/animation.js +579 -0
  28. package/dist/tools/assets.d.ts +21 -0
  29. package/dist/tools/assets.js +304 -0
  30. package/dist/tools/audio.d.ts +170 -0
  31. package/dist/tools/audio.js +416 -0
  32. package/dist/tools/blueprint.d.ts +144 -0
  33. package/dist/tools/blueprint.js +652 -0
  34. package/dist/tools/build_environment_advanced.d.ts +66 -0
  35. package/dist/tools/build_environment_advanced.js +484 -0
  36. package/dist/tools/consolidated-tool-definitions.d.ts +2598 -0
  37. package/dist/tools/consolidated-tool-definitions.js +607 -0
  38. package/dist/tools/consolidated-tool-handlers.d.ts +2 -0
  39. package/dist/tools/consolidated-tool-handlers.js +1050 -0
  40. package/dist/tools/debug.d.ts +185 -0
  41. package/dist/tools/debug.js +265 -0
  42. package/dist/tools/editor.d.ts +88 -0
  43. package/dist/tools/editor.js +365 -0
  44. package/dist/tools/engine.d.ts +30 -0
  45. package/dist/tools/engine.js +36 -0
  46. package/dist/tools/foliage.d.ts +155 -0
  47. package/dist/tools/foliage.js +525 -0
  48. package/dist/tools/introspection.d.ts +98 -0
  49. package/dist/tools/introspection.js +683 -0
  50. package/dist/tools/landscape.d.ts +158 -0
  51. package/dist/tools/landscape.js +375 -0
  52. package/dist/tools/level.d.ts +110 -0
  53. package/dist/tools/level.js +362 -0
  54. package/dist/tools/lighting.d.ts +159 -0
  55. package/dist/tools/lighting.js +1179 -0
  56. package/dist/tools/materials.d.ts +34 -0
  57. package/dist/tools/materials.js +146 -0
  58. package/dist/tools/niagara.d.ts +145 -0
  59. package/dist/tools/niagara.js +289 -0
  60. package/dist/tools/performance.d.ts +163 -0
  61. package/dist/tools/performance.js +412 -0
  62. package/dist/tools/physics.d.ts +189 -0
  63. package/dist/tools/physics.js +784 -0
  64. package/dist/tools/rc.d.ts +110 -0
  65. package/dist/tools/rc.js +363 -0
  66. package/dist/tools/sequence.d.ts +112 -0
  67. package/dist/tools/sequence.js +675 -0
  68. package/dist/tools/tool-definitions.d.ts +4919 -0
  69. package/dist/tools/tool-definitions.js +891 -0
  70. package/dist/tools/tool-handlers.d.ts +47 -0
  71. package/dist/tools/tool-handlers.js +830 -0
  72. package/dist/tools/ui.d.ts +171 -0
  73. package/dist/tools/ui.js +337 -0
  74. package/dist/tools/visual.d.ts +29 -0
  75. package/dist/tools/visual.js +67 -0
  76. package/dist/types/env.d.ts +10 -0
  77. package/dist/types/env.js +18 -0
  78. package/dist/types/index.d.ts +323 -0
  79. package/dist/types/index.js +28 -0
  80. package/dist/types/tool-types.d.ts +274 -0
  81. package/dist/types/tool-types.js +13 -0
  82. package/dist/unreal-bridge.d.ts +126 -0
  83. package/dist/unreal-bridge.js +992 -0
  84. package/dist/utils/cache-manager.d.ts +64 -0
  85. package/dist/utils/cache-manager.js +176 -0
  86. package/dist/utils/error-handler.d.ts +66 -0
  87. package/dist/utils/error-handler.js +243 -0
  88. package/dist/utils/errors.d.ts +133 -0
  89. package/dist/utils/errors.js +256 -0
  90. package/dist/utils/http.d.ts +26 -0
  91. package/dist/utils/http.js +135 -0
  92. package/dist/utils/logger.d.ts +12 -0
  93. package/dist/utils/logger.js +32 -0
  94. package/dist/utils/normalize.d.ts +17 -0
  95. package/dist/utils/normalize.js +49 -0
  96. package/dist/utils/response-validator.d.ts +34 -0
  97. package/dist/utils/response-validator.js +121 -0
  98. package/dist/utils/safe-json.d.ts +4 -0
  99. package/dist/utils/safe-json.js +97 -0
  100. package/dist/utils/stdio-redirect.d.ts +2 -0
  101. package/dist/utils/stdio-redirect.js +20 -0
  102. package/dist/utils/validation.d.ts +50 -0
  103. package/dist/utils/validation.js +173 -0
  104. package/mcp-config-example.json +14 -0
  105. package/package.json +63 -0
  106. package/server.json +60 -0
  107. package/src/cli.ts +7 -0
  108. package/src/index.ts +543 -0
  109. package/src/prompts/index.ts +51 -0
  110. package/src/python/editor_compat.py +181 -0
  111. package/src/python-utils.ts +57 -0
  112. package/src/resources/actors.ts +92 -0
  113. package/src/resources/assets.ts +251 -0
  114. package/src/resources/levels.ts +83 -0
  115. package/src/tools/actors.ts +480 -0
  116. package/src/tools/animation.ts +713 -0
  117. package/src/tools/assets.ts +305 -0
  118. package/src/tools/audio.ts +548 -0
  119. package/src/tools/blueprint.ts +736 -0
  120. package/src/tools/build_environment_advanced.ts +526 -0
  121. package/src/tools/consolidated-tool-definitions.ts +619 -0
  122. package/src/tools/consolidated-tool-handlers.ts +1093 -0
  123. package/src/tools/debug.ts +368 -0
  124. package/src/tools/editor.ts +360 -0
  125. package/src/tools/engine.ts +32 -0
  126. package/src/tools/foliage.ts +652 -0
  127. package/src/tools/introspection.ts +778 -0
  128. package/src/tools/landscape.ts +523 -0
  129. package/src/tools/level.ts +410 -0
  130. package/src/tools/lighting.ts +1316 -0
  131. package/src/tools/materials.ts +148 -0
  132. package/src/tools/niagara.ts +312 -0
  133. package/src/tools/performance.ts +549 -0
  134. package/src/tools/physics.ts +924 -0
  135. package/src/tools/rc.ts +437 -0
  136. package/src/tools/sequence.ts +791 -0
  137. package/src/tools/tool-definitions.ts +907 -0
  138. package/src/tools/tool-handlers.ts +941 -0
  139. package/src/tools/ui.ts +499 -0
  140. package/src/tools/visual.ts +60 -0
  141. package/src/types/env.ts +27 -0
  142. package/src/types/index.ts +414 -0
  143. package/src/types/tool-types.ts +343 -0
  144. package/src/unreal-bridge.ts +1118 -0
  145. package/src/utils/cache-manager.ts +213 -0
  146. package/src/utils/error-handler.ts +320 -0
  147. package/src/utils/errors.ts +312 -0
  148. package/src/utils/http.ts +184 -0
  149. package/src/utils/logger.ts +30 -0
  150. package/src/utils/normalize.ts +54 -0
  151. package/src/utils/response-validator.ts +145 -0
  152. package/src/utils/safe-json.ts +112 -0
  153. package/src/utils/stdio-redirect.ts +18 -0
  154. package/src/utils/validation.ts +212 -0
  155. package/tsconfig.json +33 -0
@@ -0,0 +1,189 @@
1
+ import { UnrealBridge } from '../unreal-bridge.js';
2
+ export declare class PhysicsTools {
3
+ private bridge;
4
+ constructor(bridge: UnrealBridge);
5
+ /**
6
+ * Helper to find a valid skeletal mesh in the project
7
+ */
8
+ private findValidSkeletalMesh;
9
+ /**
10
+ * Setup Ragdoll Physics
11
+ * NOTE: Requires a valid skeletal mesh to create physics asset
12
+ * @param skeletonPath - Path to an existing skeletal mesh asset (required)
13
+ * @param physicsAssetName - Name for the new physics asset
14
+ * @param savePath - Directory to save the asset (default: /Game/Physics)
15
+ */
16
+ setupRagdoll(params: {
17
+ skeletonPath: string;
18
+ physicsAssetName: string;
19
+ savePath?: string;
20
+ blendWeight?: number;
21
+ constraints?: Array<{
22
+ boneName: string;
23
+ constraintType: 'Fixed' | 'Limited' | 'Free';
24
+ limits?: {
25
+ swing1?: number;
26
+ swing2?: number;
27
+ twist?: number;
28
+ };
29
+ }>;
30
+ }): Promise<{
31
+ success: boolean;
32
+ message: string;
33
+ error: string | undefined;
34
+ path?: undefined;
35
+ } | {
36
+ success: boolean;
37
+ message: string;
38
+ path: string;
39
+ error?: undefined;
40
+ } | {
41
+ success: boolean;
42
+ error: string;
43
+ message?: undefined;
44
+ path?: undefined;
45
+ }>;
46
+ /**
47
+ * Create Physics Constraint
48
+ */
49
+ createConstraint(params: {
50
+ name: string;
51
+ actor1: string;
52
+ actor2: string;
53
+ constraintType: 'Fixed' | 'Hinge' | 'Prismatic' | 'Ball' | 'Cone';
54
+ location: [number, number, number];
55
+ breakThreshold?: number;
56
+ limits?: {
57
+ swing1?: number;
58
+ swing2?: number;
59
+ twist?: number;
60
+ linear?: number;
61
+ };
62
+ }): Promise<{
63
+ success: boolean;
64
+ message: string;
65
+ error?: undefined;
66
+ } | {
67
+ success: boolean;
68
+ error: string;
69
+ message?: undefined;
70
+ }>;
71
+ /**
72
+ * Setup Chaos Destruction
73
+ */
74
+ setupDestruction(params: {
75
+ meshPath: string;
76
+ destructionName: string;
77
+ savePath?: string;
78
+ fractureSettings?: {
79
+ cellCount: number;
80
+ minimumVolumeSize: number;
81
+ seed: number;
82
+ };
83
+ damageThreshold?: number;
84
+ debrisLifetime?: number;
85
+ }): Promise<{
86
+ success: boolean;
87
+ message: string;
88
+ path: string;
89
+ error?: undefined;
90
+ } | {
91
+ success: boolean;
92
+ error: string;
93
+ message?: undefined;
94
+ path?: undefined;
95
+ }>;
96
+ /**
97
+ * Configure Vehicle Physics
98
+ */
99
+ configureVehicle(params: {
100
+ vehicleName: string;
101
+ vehicleType: 'Car' | 'Bike' | 'Tank' | 'Aircraft';
102
+ wheels?: Array<{
103
+ name: string;
104
+ radius: number;
105
+ width: number;
106
+ mass: number;
107
+ isSteering: boolean;
108
+ isDriving: boolean;
109
+ }>;
110
+ engine?: {
111
+ maxRPM: number;
112
+ torqueCurve: Array<[number, number]>;
113
+ };
114
+ transmission?: {
115
+ gears: number[];
116
+ finalDriveRatio: number;
117
+ };
118
+ }): Promise<{
119
+ success: boolean;
120
+ message: string;
121
+ error?: undefined;
122
+ } | {
123
+ success: boolean;
124
+ error: string;
125
+ message?: undefined;
126
+ }>;
127
+ /**
128
+ * Apply Force or Impulse to Actor
129
+ */
130
+ applyForce(params: {
131
+ actorName: string;
132
+ forceType: 'Force' | 'Impulse' | 'Velocity' | 'Torque';
133
+ vector: [number, number, number];
134
+ boneName?: string;
135
+ isLocal?: boolean;
136
+ }): Promise<any>;
137
+ /**
138
+ * Configure Cloth Simulation
139
+ */
140
+ setupCloth(params: {
141
+ meshName: string;
142
+ clothPreset: 'Silk' | 'Leather' | 'Denim' | 'Rubber' | 'Custom';
143
+ customSettings?: {
144
+ stiffness?: number;
145
+ damping?: number;
146
+ friction?: number;
147
+ density?: number;
148
+ gravity?: number;
149
+ windVelocity?: [number, number, number];
150
+ };
151
+ }): Promise<{
152
+ success: boolean;
153
+ message: string;
154
+ error?: undefined;
155
+ } | {
156
+ success: boolean;
157
+ error: string;
158
+ message?: undefined;
159
+ }>;
160
+ /**
161
+ * Create Fluid Simulation (Niagara-based)
162
+ */
163
+ createFluidSimulation(params: {
164
+ name: string;
165
+ fluidType: 'Water' | 'Smoke' | 'Fire' | 'Lava' | 'Custom';
166
+ location: [number, number, number];
167
+ volume: [number, number, number];
168
+ customSettings?: {
169
+ viscosity?: number;
170
+ density?: number;
171
+ temperature?: number;
172
+ turbulence?: number;
173
+ color?: [number, number, number, number];
174
+ };
175
+ }): Promise<{
176
+ success: boolean;
177
+ message: string;
178
+ error?: undefined;
179
+ } | {
180
+ success: boolean;
181
+ error: string;
182
+ message?: undefined;
183
+ }>;
184
+ /**
185
+ * Helper function to execute console commands
186
+ */
187
+ private _executeCommand;
188
+ }
189
+ //# sourceMappingURL=physics.d.ts.map