unreal-engine-mcp-server 0.4.7 → 0.5.0

package/.env.example

@@ -0,0 +1,26 @@
+# Server Settings
+NODE_ENV=development
+LOG_LEVEL=info
+MCP_ROUTE_STDOUT_LOGS=true
+
+# Unreal Engine Settings
+UE_PROJECT_PATH="C:/Users/YourName/Documents/Unreal Projects/YourProject/YourProject.uproject"
+# UE_EDITOR_EXE="C:/Program Files/Epic Games/UE_5.7/Engine/Binaries/Win64/UnrealEditor.exe"
+# UE_SCREENSHOT_DIR="C:/Users/YourName/Documents/Unreal Projects/YourProject/Saved/Screenshots"
+
+# Automation Bridge Connection (Node -> Unreal)
+MCP_AUTOMATION_HOST=127.0.0.1
+MCP_AUTOMATION_PORT=8091
+MCP_AUTOMATION_CLIENT_MODE=true
+
+# WebAssembly Acceleration
+WASM_ENABLED=true
+# WASM_PATH=file:///absolute/path/to/unreal_mcp_wasm.js
+
+# Timeouts
+MCP_CONNECTION_TIMEOUT_MS=5000
+MCP_REQUEST_TIMEOUT_MS=30000
+
+# Legacy/Alternative Variables (for backward compatibility)
+# MCP_AUTOMATION_WS_PORT=8090
+# MCP_AUTOMATION_BRIDGE_ENABLED=true

package/.env.production

@@ -1,9 +1,7 @@
 # Production Configuration for Unreal Engine MCP Server
 
-# Unreal Engine Remote Control Settings
-UE_HOST=127.0.0.1
-UE_RC_HTTP_PORT=30010
-UE_RC_WS_PORT=30020
+# Unreal Engine Automation Settings
+MCP_AUTOMATION_WS_PORT=8090
 
 # Tool Mode Configuration
 # Set to 'false' to use individual tools (36+), 'true' or unset for consolidated (10)
@@ -17,9 +15,9 @@ USE_CONSOLIDATED_TOOLS=true
 # - debug  : full debug, very verbose
 LOG_LEVEL=info
 
-# Server Settings
-SERVER_NAME=unreal-engine-mcp
-SERVER_VERSION=0.4.7
+# Server Configuration
+MCP_SERVER_NAME=unreal-engine-mcp
+MCP_SERVER_VERSION=0.5.0
 
 # Connection Settings
 MAX_RETRY_ATTEMPTS=3
@@ -28,3 +26,36 @@ RETRY_DELAY_MS=2000
 # Performance Settings
 REQUEST_TIMEOUT_MS=30000
 WEBSOCKET_KEEPALIVE_MS=30000
+WASM_ENABLED=true
+
+# Automation Bridge / WebSocket
+MCP_AUTOMATION_WS_HOST=127.0.0.1
+MCP_AUTOMATION_WS_PORTS=8090,8091
+MCP_AUTOMATION_WS_PROTOCOLS=mcp-automation
+MCP_AUTOMATION_BRIDGE_ENABLED=true
+MCP_AUTOMATION_SERVER_LEGACY=true
+MCP_AUTOMATION_CLIENT_MODE=true
+MCP_AUTOMATION_CLIENT_HOST=127.0.0.1
+MCP_AUTOMATION_CLIENT_PORT=8090
+
+# MCP timeouts and caching
+MCP_AUTOMATION_REQUEST_TIMEOUT_MS=120000
+MCP_AUTOMATION_PLUGIN_CREATE_TIMEOUT_MS=15000
+MCP_AUTOMATION_SCS_TIMEOUT_MS=120000
+MCP_AUTOMATION_EVENT_TIMEOUT_MS=0
+ASSET_LIST_TTL_MS=10000
+MCP_ROUTE_STDOUT_LOGS=true
+
+# GraphQL API (disabled by default)
+GRAPHQL_ENABLED=false
+GRAPHQL_PORT=4000
+GRAPHQL_HOST=127.0.0.1
+GRAPHQL_PATH=/graphql
+GRAPHQL_CORS_ORIGIN=*
+GRAPHQL_CORS_CREDENTIALS=false
+
+# Elicitation and environment defaults
+MCP_ELICITATION_TIMEOUT_MS=180000
+MCP_ENV_DEFAULT_TIME_OF_DAY=14
+MCP_ENV_DEFAULT_SUN_INTENSITY=5
+MCP_ENV_DEFAULT_SKYLIGHT_INTENSITY=1

package/.eslintrc.json

@@ -1,54 +0,0 @@
-{
-  "root": true,
-  "parser": "@typescript-eslint/parser",
-  "parserOptions": {
-    "ecmaVersion": 2022,
-    "sourceType": "module",
-    "project": "./tsconfig.json"
-  },
-  "plugins": [
-    "@typescript-eslint"
-  ],
-  "extends": [
-    "eslint:recommended",
-    "plugin:@typescript-eslint/recommended"
-  ],
-  "env": {
-    "node": true,
-    "es2022": true
-  },
-  "rules": {
-    "@typescript-eslint/no-unused-vars": [
-      "warn",
-      {
-        "args": "all",
-        "argsIgnorePattern": "^_",
-        "caughtErrors": "all",
-        "caughtErrorsIgnorePattern": "^_",
-        "destructuredArrayIgnorePattern": "^_",
-        "varsIgnorePattern": "^_",
-        "ignoreRestSiblings": true
-      }
-    ],
-    "@typescript-eslint/no-explicit-any": "off",
-    "@typescript-eslint/explicit-module-boundary-types": "off",
-    "@typescript-eslint/no-non-null-assertion": "warn",
-    "no-console": "off",
-    "semi": ["error", "always"],
-    "quotes": ["error", "single", { "avoidEscape": true }],
-    "no-empty": ["error", { "allowEmptyCatch": true }],
-    "no-useless-escape": "warn",
-    "no-case-declarations": "off",
-    "prefer-const": "warn",
-    "no-unused-vars": "off"
-  },
-  "ignorePatterns": [
-    "dist/",
-    "node_modules/",
-    "*.js",
-    "*.d.ts",
-    "*.cjs",
-    "vitest.config.ts",
-    "test-*.js"
-  ]
-}

package/.eslintrc.override.json

@@ -0,0 +1,8 @@
+{
+  "extends": "plugin:@typescript-eslint/recommended",
+  "parser": "@typescript-eslint/parser",
+  "rules": {
+    "@typescript-eslint/no-unused-vars": ["warn", { "argsIgnorePattern": "^_", "varsIgnorePattern": "^_" }],
+    "@typescript-eslint/no-non-null-assertion": "off"
+  }
+}

package/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,94 @@
+name: 'Bug Report'
+description: 'Report a bug to help us improve Unreal Engine MCP Server'
+labels:
+  - 'bug'
+body:
+  - type: 'markdown'
+    attributes:
+      value: |-
+        > [!IMPORTANT]
+        > Thanks for taking the time to fill out this bug report!
+        >
+        > Please search **[existing issues](https://github.com/ChiR24/Unreal_mcp/issues)** to see if an issue already exists for the bug you encountered.
+
+  - type: 'textarea'
+    id: 'problem'
+    attributes:
+      label: 'What happened?'
+      description: 'A clear and concise description of what the bug is.'
+    validations:
+      required: true
+
+  - type: 'textarea'
+    id: 'expected'
+    attributes:
+      label: 'What did you expect to happen?'
+    validations:
+      required: true
+
+  - type: 'dropdown'
+    id: 'ue-version'
+    attributes:
+      label: 'Unreal Engine Version'
+      options:
+        - 'UE 5.0'
+        - 'UE 5.1'
+        - 'UE 5.2'
+        - 'UE 5.3'
+        - 'UE 5.4'
+        - 'UE 5.5'
+        - 'UE 5.6'
+        - 'UE 5.7'
+        - 'Other'
+    validations:
+      required: true
+
+  - type: 'dropdown'
+    id: 'mcp-client'
+    attributes:
+      label: 'MCP Client'
+      options:
+        - 'Claude Desktop'
+        - 'Cursor'
+        - 'VS Code (Copilot)'
+        - 'Custom MCP Client'
+        - 'Other'
+    validations:
+      required: true
+
+  - type: 'textarea'
+    id: 'environment'
+    attributes:
+      label: 'Environment Information'
+      description: 'Please include OS, Node.js version, and any relevant environment details.'
+      value: |-
+        - **OS**: [e.g., Windows 11, macOS Sonoma, Ubuntu 22.04]
+        - **Node.js Version**: [e.g., 18.x, 20.x]
+        - **MCP Server Version**: [e.g., 0.5.0]
+    validations:
+      required: true
+
+  - type: 'textarea'
+    id: 'reproduction'
+    attributes:
+      label: 'Steps to Reproduce'
+      description: 'How can we reproduce the issue?'
+      value: |-
+        1. 
+        2. 
+        3. 
+    validations:
+      required: true
+
+  - type: 'textarea'
+    id: 'logs'
+    attributes:
+      label: 'Relevant Logs'
+      description: 'Paste any relevant error logs or console output.'
+      render: 'shell'
+
+  - type: 'textarea'
+    id: 'additional-context'
+    attributes:
+      label: 'Additional Context'
+      description: 'Add any other context or screenshots about the problem here.'

package/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,8 @@
+blank_issues_enabled: false
+contact_links:
+  - name: 'Documentation'
+    url: 'https://github.com/ChiR24/Unreal_mcp/tree/main/docs'
+    about: 'Check the documentation for usage guides and API reference.'
+  - name: 'Discussions'
+    url: 'https://github.com/ChiR24/Unreal_mcp/discussions'
+    about: 'Ask questions and share ideas with the community.'

package/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,56 @@
+name: 'Feature Request'
+description: 'Suggest a new feature or improvement for Unreal Engine MCP Server'
+labels:
+  - 'enhancement'
+body:
+  - type: 'markdown'
+    attributes:
+      value: |-
+        > [!IMPORTANT]
+        > Thanks for taking the time to suggest an enhancement!
+        >
+        > Please search **[existing issues](https://github.com/ChiR24/Unreal_mcp/issues)** to see if a similar feature has already been requested.
+
+  - type: 'textarea'
+    id: 'feature'
+    attributes:
+      label: 'What would you like to be added?'
+      description: 'A clear and concise description of the enhancement.'
+    validations:
+      required: true
+
+  - type: 'dropdown'
+    id: 'category'
+    attributes:
+      label: 'Feature Category'
+      options:
+        - 'New Tool'
+        - 'Existing Tool Enhancement'
+        - 'Plugin (C++)'
+        - 'Performance'
+        - 'Documentation'
+        - 'Testing'
+        - 'Developer Experience'
+        - 'Other'
+    validations:
+      required: true
+
+  - type: 'textarea'
+    id: 'rationale'
+    attributes:
+      label: 'Why is this needed?'
+      description: 'A clear and concise description of why this enhancement is needed.'
+    validations:
+      required: true
+
+  - type: 'textarea'
+    id: 'alternatives'
+    attributes:
+      label: 'Alternatives Considered'
+      description: 'Any alternative solutions or features you have considered.'
+
+  - type: 'textarea'
+    id: 'additional-context'
+    attributes:
+      label: 'Additional Context'
+      description: 'Add any other context, mockups, or screenshots about the feature request here.'