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.
- package/.dockerignore +57 -0
- package/.env.production +25 -0
- package/.eslintrc.json +54 -0
- package/.github/workflows/publish-mcp.yml +75 -0
- package/Dockerfile +54 -0
- package/LICENSE +21 -0
- package/Public/icon.png +0 -0
- package/README.md +209 -0
- package/claude_desktop_config_example.json +13 -0
- package/dist/cli.d.ts +3 -0
- package/dist/cli.js +7 -0
- package/dist/index.d.ts +31 -0
- package/dist/index.js +484 -0
- package/dist/prompts/index.d.ts +14 -0
- package/dist/prompts/index.js +38 -0
- package/dist/python-utils.d.ts +29 -0
- package/dist/python-utils.js +54 -0
- package/dist/resources/actors.d.ts +13 -0
- package/dist/resources/actors.js +83 -0
- package/dist/resources/assets.d.ts +23 -0
- package/dist/resources/assets.js +245 -0
- package/dist/resources/levels.d.ts +17 -0
- package/dist/resources/levels.js +94 -0
- package/dist/tools/actors.d.ts +51 -0
- package/dist/tools/actors.js +459 -0
- package/dist/tools/animation.d.ts +196 -0
- package/dist/tools/animation.js +579 -0
- package/dist/tools/assets.d.ts +21 -0
- package/dist/tools/assets.js +304 -0
- package/dist/tools/audio.d.ts +170 -0
- package/dist/tools/audio.js +416 -0
- package/dist/tools/blueprint.d.ts +144 -0
- package/dist/tools/blueprint.js +652 -0
- package/dist/tools/build_environment_advanced.d.ts +66 -0
- package/dist/tools/build_environment_advanced.js +484 -0
- package/dist/tools/consolidated-tool-definitions.d.ts +2598 -0
- package/dist/tools/consolidated-tool-definitions.js +607 -0
- package/dist/tools/consolidated-tool-handlers.d.ts +2 -0
- package/dist/tools/consolidated-tool-handlers.js +1050 -0
- package/dist/tools/debug.d.ts +185 -0
- package/dist/tools/debug.js +265 -0
- package/dist/tools/editor.d.ts +88 -0
- package/dist/tools/editor.js +365 -0
- package/dist/tools/engine.d.ts +30 -0
- package/dist/tools/engine.js +36 -0
- package/dist/tools/foliage.d.ts +155 -0
- package/dist/tools/foliage.js +525 -0
- package/dist/tools/introspection.d.ts +98 -0
- package/dist/tools/introspection.js +683 -0
- package/dist/tools/landscape.d.ts +158 -0
- package/dist/tools/landscape.js +375 -0
- package/dist/tools/level.d.ts +110 -0
- package/dist/tools/level.js +362 -0
- package/dist/tools/lighting.d.ts +159 -0
- package/dist/tools/lighting.js +1179 -0
- package/dist/tools/materials.d.ts +34 -0
- package/dist/tools/materials.js +146 -0
- package/dist/tools/niagara.d.ts +145 -0
- package/dist/tools/niagara.js +289 -0
- package/dist/tools/performance.d.ts +163 -0
- package/dist/tools/performance.js +412 -0
- package/dist/tools/physics.d.ts +189 -0
- package/dist/tools/physics.js +784 -0
- package/dist/tools/rc.d.ts +110 -0
- package/dist/tools/rc.js +363 -0
- package/dist/tools/sequence.d.ts +112 -0
- package/dist/tools/sequence.js +675 -0
- package/dist/tools/tool-definitions.d.ts +4919 -0
- package/dist/tools/tool-definitions.js +891 -0
- package/dist/tools/tool-handlers.d.ts +47 -0
- package/dist/tools/tool-handlers.js +830 -0
- package/dist/tools/ui.d.ts +171 -0
- package/dist/tools/ui.js +337 -0
- package/dist/tools/visual.d.ts +29 -0
- package/dist/tools/visual.js +67 -0
- package/dist/types/env.d.ts +10 -0
- package/dist/types/env.js +18 -0
- package/dist/types/index.d.ts +323 -0
- package/dist/types/index.js +28 -0
- package/dist/types/tool-types.d.ts +274 -0
- package/dist/types/tool-types.js +13 -0
- package/dist/unreal-bridge.d.ts +126 -0
- package/dist/unreal-bridge.js +992 -0
- package/dist/utils/cache-manager.d.ts +64 -0
- package/dist/utils/cache-manager.js +176 -0
- package/dist/utils/error-handler.d.ts +66 -0
- package/dist/utils/error-handler.js +243 -0
- package/dist/utils/errors.d.ts +133 -0
- package/dist/utils/errors.js +256 -0
- package/dist/utils/http.d.ts +26 -0
- package/dist/utils/http.js +135 -0
- package/dist/utils/logger.d.ts +12 -0
- package/dist/utils/logger.js +32 -0
- package/dist/utils/normalize.d.ts +17 -0
- package/dist/utils/normalize.js +49 -0
- package/dist/utils/response-validator.d.ts +34 -0
- package/dist/utils/response-validator.js +121 -0
- package/dist/utils/safe-json.d.ts +4 -0
- package/dist/utils/safe-json.js +97 -0
- package/dist/utils/stdio-redirect.d.ts +2 -0
- package/dist/utils/stdio-redirect.js +20 -0
- package/dist/utils/validation.d.ts +50 -0
- package/dist/utils/validation.js +173 -0
- package/mcp-config-example.json +14 -0
- package/package.json +63 -0
- package/server.json +60 -0
- package/src/cli.ts +7 -0
- package/src/index.ts +543 -0
- package/src/prompts/index.ts +51 -0
- package/src/python/editor_compat.py +181 -0
- package/src/python-utils.ts +57 -0
- package/src/resources/actors.ts +92 -0
- package/src/resources/assets.ts +251 -0
- package/src/resources/levels.ts +83 -0
- package/src/tools/actors.ts +480 -0
- package/src/tools/animation.ts +713 -0
- package/src/tools/assets.ts +305 -0
- package/src/tools/audio.ts +548 -0
- package/src/tools/blueprint.ts +736 -0
- package/src/tools/build_environment_advanced.ts +526 -0
- package/src/tools/consolidated-tool-definitions.ts +619 -0
- package/src/tools/consolidated-tool-handlers.ts +1093 -0
- package/src/tools/debug.ts +368 -0
- package/src/tools/editor.ts +360 -0
- package/src/tools/engine.ts +32 -0
- package/src/tools/foliage.ts +652 -0
- package/src/tools/introspection.ts +778 -0
- package/src/tools/landscape.ts +523 -0
- package/src/tools/level.ts +410 -0
- package/src/tools/lighting.ts +1316 -0
- package/src/tools/materials.ts +148 -0
- package/src/tools/niagara.ts +312 -0
- package/src/tools/performance.ts +549 -0
- package/src/tools/physics.ts +924 -0
- package/src/tools/rc.ts +437 -0
- package/src/tools/sequence.ts +791 -0
- package/src/tools/tool-definitions.ts +907 -0
- package/src/tools/tool-handlers.ts +941 -0
- package/src/tools/ui.ts +499 -0
- package/src/tools/visual.ts +60 -0
- package/src/types/env.ts +27 -0
- package/src/types/index.ts +414 -0
- package/src/types/tool-types.ts +343 -0
- package/src/unreal-bridge.ts +1118 -0
- package/src/utils/cache-manager.ts +213 -0
- package/src/utils/error-handler.ts +320 -0
- package/src/utils/errors.ts +312 -0
- package/src/utils/http.ts +184 -0
- package/src/utils/logger.ts +30 -0
- package/src/utils/normalize.ts +54 -0
- package/src/utils/response-validator.ts +145 -0
- package/src/utils/safe-json.ts +112 -0
- package/src/utils/stdio-redirect.ts +18 -0
- package/src/utils/validation.ts +212 -0
- 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
|