unreal-engine-mcp-server 0.4.7 → 0.5.1

package/smithery.yaml

@@ -1,29 +0,0 @@
-name: "Unreal Engine MCP"
-description: "A comprehensive Model Context Protocol (MCP) server that enables AI assistants to control Unreal Engine via Remote Control API. Built with TypeScript and designed for game development automation."
-runtime: "typescript"
-env:
-  NODE_ENV: "production"
-  LOG_LEVEL: "info"
-  UE_PROJECT_PATH: "C:/Users/YourName/Documents/Unreal Projects/YourProject"
-# Session configuration hints (served by the exported Zod configSchema in src/index.ts)
-sessionConfig:
-  ueHost:
-    type: string
-    description: "Unreal Engine host (e.g., 127.0.0.1)"
-    default: "127.0.0.1"
-  ueHttpPort:
-    type: number
-    description: "Remote Control HTTP port"
-    default: 30010
-  ueWsPort:
-    type: number
-    description: "Remote Control WS port"
-    default: 30011
-  logLevel:
-    type: string
-    description: "Server log verbosity"
-    default: "info"
-  projectPath:
-    type: string
-    description: "Absolute path to your .uproject file"
-    default: "C:/Users/YourName/Documents/Unreal Projects/YourProject"

package/src/prompts/index.ts

@@ -1,249 +0,0 @@
-export interface PromptArgument {
-  type: string;
-  description?: string;
-  enum?: string[];
-  default?: unknown;
-  required?: boolean;
-}
-
-export interface PromptTemplate {
-  name: string;
-  description: string;
-  arguments?: Record<string, PromptArgument>;
-  build: (args: Record<string, unknown>) => Array<{
-    role: 'user' | 'assistant';
-    content: { type: 'text'; text: string };
-  }>;
-}
-
-function clampChoice(value: unknown, choices: string[], fallback: string): string {
-  if (typeof value === 'string') {
-    const normalized = value.toLowerCase();
-    if (choices.includes(normalized)) {
-      return normalized;
-    }
-  }
-  return fallback;
-}
-
-function coerceNumber(value: unknown, fallback: number, min?: number, max?: number): number {
-  const num = typeof value === 'number' ? value : Number(value);
-  if (!Number.isFinite(num)) {
-    return fallback;
-  }
-  if (min !== undefined && num < min) {
-    return min;
-  }
-  if (max !== undefined && num > max) {
-    return max;
-  }
-  return num;
-}
-
-function formatVector(value: unknown): string | null {
-  if (!value || typeof value !== 'object') {
-    return null;
-  }
-  const vector = value as Record<string, unknown>;
-  const x = typeof vector.x === 'number' ? vector.x : Number(vector.x);
-  const y = typeof vector.y === 'number' ? vector.y : Number(vector.y);
-  const z = typeof vector.z === 'number' ? vector.z : Number(vector.z);
-  if ([x, y, z].some((component) => !Number.isFinite(component))) {
-    return null;
-  }
-  return `${x.toFixed(2)}, ${y.toFixed(2)}, ${z.toFixed(2)}`;
-}
-
-export const prompts: PromptTemplate[] = [
-  {
-    name: 'setup_three_point_lighting',
-    description: 'Author a cinematic three-point lighting rig aligned to the active camera focus.',
-    arguments: {
-      intensity: {
-        type: 'string',
-        enum: ['low', 'medium', 'high'],
-        default: 'medium',
-        description: 'Overall lighting mood. Low = dramatic contrast, high = bright key light.'
-      }
-    },
-    build: (args) => {
-      const intensity = clampChoice(args.intensity, ['low', 'medium', 'high'], 'medium');
-      const moodHints: Record<string, string> = {
-        low: 'gentle key with strong contrast and subtle rim highlights',
-        medium: 'balanced key/fill ratio for natural coverage',
-        high: 'bright key with energetic fill and crisp rim separation'
-      };
-
-      const text = `Configure a three-point lighting rig around the current cinematic focus.
-
-Tasks:
-- Position a key light roughly 45° off-axis at eye level. Target the subject center and tune intensity for ${intensity} output (${moodHints[intensity]}).
-- Add a fill light on the opposite side with wider spread and softened shadows to control contrast.
-- Place a rim/back light to outline silhouettes and separate the subject from the background.
-- Ensure all lights use physically plausible color temperature, enable shadow casting where helpful, and adjust attenuation to avoid spill.
-- Once balanced, report the final intensity values, color temperatures, and any blockers encountered.`;
-
-      return [{
-        role: 'user',
-        content: { type: 'text', text }
-      }];
-    }
-  },
-  {
-    name: 'create_fps_controller',
-    description: 'Spin up a first-person controller blueprint with input mappings, collision, and starter movement.',
-    arguments: {
-      spawnLocation: {
-        type: 'vector',
-        description: 'Optional XYZ spawn position for the player pawn.',
-        required: false
-      }
-    },
-    build: (args) => {
-      const spawnVector = formatVector(args.spawnLocation);
-      const spawnLine = spawnVector ? `Spawn the pawn at world coordinates (${spawnVector}).` : 'Spawn the pawn at a safe default player start or the origin.';
-
-      const text = `Build a First Person Character blueprint with:
-- Camera + arms mesh, basic WASD input, jump, crouch, and sprint bindings using Enhanced Input.
-- Proper collision capsule sizing for a 180cm tall human.
-- Momentum-preserving air control with configurable acceleration and friction.
-- A configurable base turn rate with mouse sensitivity scaling.
-- Serialized defaults for walking speed (600 uu/s) and sprint speed (900 uu/s).
-- Expose key movement settings as editable defaults.
-- ${spawnLine}
-
-Finish by compiling, saving, and summarizing the created blueprint path plus the mapped input actions.`;
-
-      return [{
-        role: 'user',
-        content: { type: 'text', text }
-      }];
-    }
-  },
-  {
-    name: 'setup_post_processing',
-    description: 'Author a post-process volume tuned to a named cinematic grade.',
-    arguments: {
-      style: {
-        type: 'string',
-        enum: ['cinematic', 'realistic', 'stylized', 'noir'],
-        default: 'cinematic',
-        description: 'Look preset to emphasize color grading and tone-mapping style.'
-      }
-    },
-    build: (args) => {
-      const style = clampChoice(args.style, ['cinematic', 'realistic', 'stylized', 'noir'], 'cinematic');
-      const styleNotes: Record<string, string> = {
-        cinematic: 'filmic tonemapper, gentle bloom, warm highlights, cool shadows, slight vignette',
-        realistic: 'minimal grading, accurate white balance, restrained bloom, detail-preserving sharpening',
-        stylized: 'bold saturation shifts, custom color LUT, exaggerated contrast, selective bloom',
-        noir: 'monochrome conversion, strong contrast curve, subtle film grain, heavy vignette'
-      };
-
-      const text = `Create a global post-process volume with priority over level defaults.
-- Apply the "${style}" look: ${styleNotes[style]}.
-- Configure tone mapping, exposure, bloom, chromatic aberration, and LUTs as required.
-- Ensure the volume is unbound unless level-specific constraints apply.
-- Provide sanity checks for HDR output and keep auto-exposure transitions smooth.
-- Summarize all modified settings with their final numeric values or asset references.`;
-
-      return [{
-        role: 'user',
-        content: { type: 'text', text }
-      }];
-    }
-  },
-  {
-    name: 'setup_dynamic_day_night_cycle',
-    description: 'Create or update a Blueprint to drive a dynamic day/night cycle with optional weather hooks.',
-    arguments: {
-      startTime: {
-        type: 'string',
-        enum: ['dawn', 'noon', 'dusk', 'midnight'],
-        default: 'dawn',
-        description: 'Initial lighting state for the cycle.'
-      },
-      transitionMinutes: {
-        type: 'number',
-        default: 5,
-        description: 'Game-time minutes to blend between major lighting states.'
-      },
-      enableWeather: {
-        type: 'boolean',
-        default: false,
-        description: 'Whether to expose hooks for weather-driven sky adjustments.'
-      }
-    },
-    build: (args) => {
-      const startTime = clampChoice(args.startTime, ['dawn', 'noon', 'dusk', 'midnight'], 'dawn');
-      const transitionMinutes = coerceNumber(args.transitionMinutes, 5, 1, 60);
-      const enableWeather = Boolean(args.enableWeather);
-
-      const weatherLine = enableWeather
-        ? '- Expose interfaces for cloud opacity, precipitation-driven skylight updates, and lightning flashes.'
-        : '- Weather hooks are disabled; keep the blueprint lean';
-
-      const text = `Implement a Blueprint-based day/night cycle manager.
-- Start the sequence at ${startTime} lighting.
-- Advance sun rotation, skylight captures, fog, and sky atmosphere continuously with ${transitionMinutes} minute blends between key states.
-- Sync directional light intensity/color with real-world sun elevation and inject moonlight at night.
-- ${weatherLine}.
-- Provide editor controls for time-of-day multiplier and manual overrides.
-- Document the generated blueprint path and exposed parameters.`;
-
-      return [{
-        role: 'user',
-        content: { type: 'text', text }
-      }];
-    }
-  },
-  {
-    name: 'design_cinematic_camera_move',
-    description: 'Author a sequencer shot with a polished camera move and easing markers.',
-    arguments: {
-      durationSeconds: {
-        type: 'number',
-        default: 6,
-        description: 'Shot duration in seconds.'
-      },
-      moveStyle: {
-        type: 'string',
-        enum: ['push_in', 'orbit', 'tracking', 'crane'],
-        default: 'push_in',
-        description: 'Camera move archetype to emphasize.'
-      },
-      focusTarget: {
-        type: 'string',
-        description: 'Optional actor or component name to keep in focus.',
-        required: false
-      }
-    },
-    build: (args) => {
-      const duration = coerceNumber(args.durationSeconds, 6, 2, 30);
-      const moveStyle = clampChoice(args.moveStyle, ['push_in', 'orbit', 'tracking', 'crane'], 'push_in');
-      const focusLine = typeof args.focusTarget === 'string' && args.focusTarget.trim().length > 0
-        ? `Lock focus distance on "${args.focusTarget}" and animate depth of field pulls if necessary.`
-        : 'Pick the most prominent subject in frame and maintain crisp focus throughout the move.';
-
-      const moveHints: Record<string, string> = {
-        push_in: 'Ease-in push toward the subject with gentle camera roll stabilization.',
-        orbit: '360° orbit with consistent parallax and a tracked look-at target.',
-        tracking: 'Match the subject velocity along a spline with smoothed acceleration.',
-        crane: 'Combine vertical rise with lateral drift for a reveal shot.'
-      };
-
-      const text = `In Sequencer, author a ${duration.toFixed(1)} second cinematic shot.
-- Movement style: ${moveStyle} (${moveHints[moveStyle]}).
-- Key auto-exposure, camera focal length, and focal distance for a premium look.
-- Add ease-in/ease-out tangents at shot boundaries to avoid abrupt starts/stops.
-- ${focusLine}
-- Annotate the timeline with intent markers (intro beat, climax, resolve).
-- Render a preview range and summarize the created assets.`;
-
-      return [{
-        role: 'user',
-        content: { type: 'text', text }
-      }];
-    }
-  }
-];