unreal-engine-mcp-server 0.5.4 → 0.5.5

package/.github/workflows/pr-size-labeler.yml

@@ -1,137 +0,0 @@
-name: '📏 Gemini PR Size Labeler'
-
-on:
-  pull_request_target:
-    types: ['opened', 'reopened', 'synchronize']
-
-permissions:
-  pull-requests: 'write'
-  contents: 'read'
-
-concurrency:
-  group: '${{ github.workflow }}-${{ github.event.pull_request.number }}'
-  cancel-in-progress: true
-
-jobs:
-  label-pr:
-    timeout-minutes: 5
-    runs-on: 'ubuntu-latest'
-    steps:
-      - name: 'Get PR diff stats'
-        id: 'diff_stats'
-        uses: 'actions/github-script@v8'
-        with:
-          github-token: '${{ secrets.GITHUB_TOKEN }}'
-          script: |
-            const { data: pr } = await github.rest.pulls.get({
-              owner: context.repo.owner,
-              repo: context.repo.repo,
-              pull_number: context.payload.pull_request.number
-            });
-            
-            const additions = pr.additions || 0;
-            const deletions = pr.deletions || 0;
-            const totalChanges = additions + deletions;
-            const filesChanged = pr.changed_files || 0;
-            
-            core.setOutput('total_changes', totalChanges);
-            core.setOutput('files_changed', filesChanged);
-            core.setOutput('additions', additions);
-            core.setOutput('deletions', deletions);
-            
-            core.info(`PR #${pr.number}: +${additions} -${deletions} (${totalChanges} total) in ${filesChanged} files`);
-
-      - name: 'Determine size label'
-        id: 'size_label'
-        run: |
-          TOTAL=${{ steps.diff_stats.outputs.total_changes }}
-          
-          if [ $TOTAL -lt 10 ]; then
-            echo "size_label=size/xs" >> $GITHUB_OUTPUT
-          elif [ $TOTAL -lt 50 ]; then
-            echo "size_label=size/s" >> $GITHUB_OUTPUT
-          elif [ $TOTAL -lt 200 ]; then
-            echo "size_label=size/m" >> $GITHUB_OUTPUT
-          elif [ $TOTAL -lt 1000 ]; then
-            echo "size_label=size/l" >> $GITHUB_OUTPUT
-          else
-            echo "size_label=size/xl" >> $GITHUB_OUTPUT
-          fi
-
-      - name: 'Apply size label'
-        uses: 'actions/github-script@v8'
-        env:
-          SIZE_LABEL: '${{ steps.size_label.outputs.size_label }}'
-        with:
-          github-token: '${{ secrets.GITHUB_TOKEN }}'
-          script: |
-            const prNumber = context.payload.pull_request.number;
-            const newLabel = process.env.SIZE_LABEL;
-            
-            // Get current labels
-            const { data: currentLabels } = await github.rest.issues.listLabelsOnIssue({
-              owner: context.repo.owner,
-              repo: context.repo.repo,
-              issue_number: prNumber
-            });
-            
-            // Remove old size labels
-            const sizeLabels = ['size/xs', 'size/s', 'size/m', 'size/l', 'size/xl'];
-            for (const label of currentLabels) {
-              if (sizeLabels.includes(label.name) && label.name !== newLabel) {
-                await github.rest.issues.removeLabel({
-                  owner: context.repo.owner,
-                  repo: context.repo.repo,
-                  issue_number: prNumber,
-                  name: label.name
-                });
-                core.info(`Removed old label: ${label.name}`);
-              }
-            }
-            
-            // Add new size label
-            await github.rest.issues.addLabels({
-              owner: context.repo.owner,
-              repo: context.repo.repo,
-              issue_number: prNumber,
-              labels: [newLabel]
-            });
-            core.info(`Applied label: ${newLabel}`);
-
-      - name: 'Comment on large PRs'
-        if: steps.size_label.outputs.size_label == 'size/xl'
-        uses: 'actions/github-script@v8'
-        with:
-          github-token: '${{ secrets.GITHUB_TOKEN }}'
-          script: |
-            const prNumber = context.payload.pull_request.number;
-            
-            // Check if we already commented
-            const { data: comments } = await github.rest.issues.listComments({
-              owner: context.repo.owner,
-              repo: context.repo.repo,
-              issue_number: prNumber
-            });
-            
-            const botComment = comments.find(c => 
-              c.user && c.user.login && c.user.login.includes('[bot]') && 
-              c.body.includes('This pull request is quite large')
-            );
-            
-            if (!botComment) {
-              await github.rest.issues.createComment({
-                owner: context.repo.owner,
-                repo: context.repo.repo,
-                issue_number: prNumber,
-                body: `## 📏 Large PR Detected
-            
-            This pull request is quite large (1000+ lines changed), which can make reviewing challenging.
-            
-            **Suggestions:**
-            - Consider breaking this into smaller, focused PRs
-            - Separate refactoring from new features
-            - Split bug fixes from feature additions
-            
-            This helps reviewers provide better feedback and speeds up the merge process. Thank you! 🙏`
-              });
-            }

package/.github/workflows/publish-mcp.yml

@@ -1,79 +0,0 @@
-name: Publish to MCP Registry
-
-on:
-  push:
-    tags: ["v*"]
-  workflow_dispatch:
-
-jobs:
-  publish:
-    runs-on: ubuntu-latest
-    permissions:
-      id-token: write
-      contents: read
-
-    steps:
-      - name: Checkout code
-        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
-
-      - name: Setup Node.js
-        uses: actions/setup-node@395ad3262231945c25e8478fd5baf05154b1d79f # v6.1.0
-        with:
-          node-version: "20"
-          registry-url: "https://registry.npmjs.org"
-          cache: 'npm'
-
-      - name: Install dependencies
-        run: npm ci
-
-      - name: Run smoke tests
-        run: npm run test:smoke
-        continue-on-error: true
-
-      - name: Run linting
-        run: npm run lint
-
-      - name: Build package
-        run: npm run build
-
-      - name: Extract version from tag
-        id: version
-        run: |
-          if [[ ${{ github.event_name }} == "push" && ${{ github.ref }} == refs/tags/* ]]; then
-            VERSION=${GITHUB_REF#refs/tags/v}
-          else
-            VERSION=$(node -p "require('./package.json').version")
-          fi
-          echo "version=$VERSION" >> $GITHUB_OUTPUT
-          echo "Publishing version: $VERSION"
-
-      - name: Update server.json version
-        run: |
-          VERSION=${{ steps.version.outputs.version }}
-          jq --arg v "$VERSION" '.version = $v | .packages[] |= if .registryType == "npm" then .version = $v else . end' server.json > tmp && mv tmp server.json
-          echo "Updated server.json:"
-          cat server.json
-
-      - name: Publish to npm
-        run: npm publish
-        continue-on-error: true
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
-
-      - name: Install MCP Publisher
-        run: |
-          curl -L "https://github.com/modelcontextprotocol/registry/releases/download/v1.4.0/mcp-publisher_$(uname -s | tr '[:upper:]' '[:lower:]')_$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/').tar.gz" | tar xz mcp-publisher
-          chmod +x mcp-publisher
-
-      - name: Login to MCP Registry
-        run: ./mcp-publisher login github-oidc
-
-      - name: Publish to MCP Registry
-        run: ./mcp-publisher publish
-
-      - name: Verify publication
-        if: ${{ always() }}
-        run: |
-          echo "Waiting for registry to update..."
-          sleep 30
-          curl -s "https://registry.modelcontextprotocol.io/v0/servers?search=io.github.ChiR24/unreal-engine-mcp" | jq '.'

package/.github/workflows/release-drafter.yml

@@ -1,24 +0,0 @@
-name: Release Drafter
-
-on:
-  push:
-    branches:
-      - main
-  workflow_dispatch:
-
-permissions:
-  contents: read
-
-jobs:
-  update_release_draft:
-    permissions:
-      contents: write
-      pull-requests: write
-    runs-on: ubuntu-latest
-    timeout-minutes: 15
-    steps:
-      - uses: release-drafter/release-drafter@v6
-        with:
-          config-name: release-drafter-config.yml
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

package/.github/workflows/release.yml

@@ -1,112 +0,0 @@
-name: Create GitHub Release
-
-on:
-  push:
-    tags:
-      - 'v*.*.*'
-
-permissions:
-  contents: write
-
-jobs:
-  release:
-    name: Create Release
-    runs-on: ubuntu-latest
-    
-    steps:
-      - name: Checkout code
-        uses: actions/checkout@v6 # v4
-        with:
-          fetch-depth: 0
-
-      - name: Setup Node.js
-        uses: actions/setup-node@v6 # v4
-        with:
-          node-version: '20'
-          cache: 'npm'
-
-      - name: Install dependencies
-        run: npm ci
-
-      - name: Build package
-        run: npm run build
-
-      - name: Extract version from tag
-        id: version
-        run: |
-          VERSION=${GITHUB_REF#refs/tags/v}
-          echo "version=$VERSION" >> $GITHUB_OUTPUT
-          echo "tag=${GITHUB_REF#refs/tags/}" >> $GITHUB_OUTPUT
-          echo "Releasing version: $VERSION"
-
-      - name: Extract changelog for this version
-        id: changelog
-        run: |
-          VERSION=${{ steps.version.outputs.version }}
-          
-          CHANGELOG=$(awk -v ver="$VERSION" '
-            $0 ~ "## .*\\[" ver "\\]" { found=1; next }
-            found && /^## .*\[/ { exit }
-            found { print }
-          ' CHANGELOG.md)
-          
-          if [ -z "$CHANGELOG" ]; then
-            CHANGELOG="Release ${{ steps.version.outputs.tag }}"
-          fi
-          
-          echo "$CHANGELOG" > release_notes.md
-          echo "Generated release notes:"
-          cat release_notes.md
-
-      - name: Create dist archive
-        run: |
-          mkdir -p release-artifacts
-          
-          tar -czvf release-artifacts/unreal-engine-mcp-server-${{ steps.version.outputs.version }}.tar.gz \
-            dist/ \
-            package.json \
-            README.md \
-            CHANGELOG.md \
-            LICENSE
-          
-          zip -r release-artifacts/unreal-engine-mcp-server-${{ steps.version.outputs.version }}.zip \
-            dist/ \
-            package.json \
-            README.md \
-            CHANGELOG.md \
-            LICENSE
-
-      - name: Create Plugin archive
-        run: |
-          if [ -d "plugins/McpAutomationBridge" ]; then
-            tar -czvf release-artifacts/McpAutomationBridge-plugin-${{ steps.version.outputs.version }}.tar.gz \
-              plugins/McpAutomationBridge/
-            
-            zip -r release-artifacts/McpAutomationBridge-plugin-${{ steps.version.outputs.version }}.zip \
-              plugins/McpAutomationBridge/
-            
-            echo "Plugin archive created"
-          else
-            echo "Plugin directory not found, skipping plugin archive"
-          fi
-
-      - name: Create GitHub Release
-        uses: softprops/action-gh-release@a06a81a03ee405af7f2048a818ed3f03bbf83c7b # v2.5.0
-        with:
-          name: Release ${{ steps.version.outputs.tag }}
-          body_path: release_notes.md
-          draft: false
-          prerelease: ${{ contains(github.ref, 'alpha') || contains(github.ref, 'beta') || contains(github.ref, 'rc') }}
-          files: |
-            release-artifacts/*
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-
-      - name: Release Summary
-        run: |
-          echo "## Release Created Successfully! 🎉" >> $GITHUB_STEP_SUMMARY
-          echo "" >> $GITHUB_STEP_SUMMARY
-          echo "**Version:** ${{ steps.version.outputs.tag }}" >> $GITHUB_STEP_SUMMARY
-          echo "" >> $GITHUB_STEP_SUMMARY
-          echo "### Artifacts:" >> $GITHUB_STEP_SUMMARY
-          ls -la release-artifacts/ >> $GITHUB_STEP_SUMMARY

package/.github/workflows/semantic-pull-request.yml

@@ -1,35 +0,0 @@
-name: "Semantic Pull Request"
-
-on:
-  pull_request_target:
-    types:
-      - opened
-      - edited
-      - synchronize
-
-permissions:
-  pull-requests: read
-  statuses: write
-
-jobs:
-  main:
-    name: Validate PR Title
-    runs-on: ubuntu-latest
-    steps:
-      - uses: amannn/action-semantic-pull-request@48f256284bd46cdaab1048c3721360e808335d50 # v6.1.1
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        with:
-          types: |
-            feat
-            fix
-            docs
-            style
-            refactor
-            perf
-            test
-            build
-            ci
-            chore
-            revert
-          requireScope: false

package/.github/workflows/smoke-test.yml

@@ -1,36 +0,0 @@
-name: Smoke Test (Mock Mode)
-permissions:
-  contents: read
-
-on:
-  push:
-    branches: [ "main" ]
-  pull_request:
-    branches: [ "main" ]
-
-concurrency:
-  group: ${{ github.workflow }}-${{ github.ref }}
-  cancel-in-progress: true
-
-jobs:
-  smoke-test:
-    runs-on: ubuntu-latest
-    steps:
-    - uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
-    
-    - name: Use Node.js
-      uses: actions/setup-node@395ad3262231945c25e8478fd5baf05154b1d79f # v6.1.0
-      with:
-        node-version: '20.x'
-        cache: 'npm'
-        
-    - name: Install dependencies
-      run: npm ci
-
-    - name: Build
-      run: npm run build
-
-    - name: Run Smoke Test
-      run: npm run test:smoke
-      env:
-        MOCK_UNREAL_CONNECTION: "true"

package/.github/workflows/stale.yml

@@ -1,28 +0,0 @@
-name: '🏷️ Stale Issue and PR Management'
-
-on:
-  schedule:
-    - cron: '0 0 * * *'
-  workflow_dispatch:
-
-permissions:
-  issues: write
-  pull-requests: write
-
-jobs:
-  stale:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/stale@997185467fa4f803885201cee163a9f38240193d # v10.1.1
-        with:
-          stale-issue-message: 'This issue has been automatically marked as stale because it has not had recent activity. It will be closed in 14 days if no further activity occurs. Thank you for your contributions!'
-          stale-pr-message: 'This pull request has been automatically marked as stale because it has not had recent activity. It will be closed in 14 days if no further activity occurs. Please update your PR or add a comment if you would like to keep it open.'
-          close-issue-message: 'This issue was closed because it has been stale for 14 days with no activity.'
-          close-pr-message: 'This pull request was closed because it has been stale for 14 days with no activity.'
-          days-before-stale: 60
-          days-before-close: 14
-          stale-issue-label: 'stale'
-          stale-pr-label: 'stale'
-          exempt-issue-labels: 'pinned,security,bug,enhancement'
-          exempt-pr-labels: 'pinned,security'
-          operations-per-run: 100

package/CONTRIBUTING.md

@@ -1,140 +0,0 @@
-# Contributing to Unreal Engine MCP Server
-
-Thank you for your interest in contributing! This document provides guidelines and instructions for contributing.
-
-## 📋 Table of Contents
-
-- [Code of Conduct](#code-of-conduct)
-- [Getting Started](#getting-started)
-- [Development Workflow](#development-workflow)
-- [Pull Request Process](#pull-request-process)
-- [Coding Standards](#coding-standards)
-
-## Code of Conduct
-
-Please be respectful and constructive in all interactions. We're building something together.
-
-## Getting Started
-
-### Prerequisites
-
-- **Node.js** 18+ 
-- **Unreal Engine** 5.0-5.7 (for live testing)
-- **Git**
-
-### Setup
-
-1. Fork and clone the repository:
-   ```bash
-   git clone https://github.com/ChiR24/Unreal_mcp.git
-   cd unreal-engine-mcp-server
-   ```
-
-2. Install dependencies:
-   ```bash
-   npm install
-   ```
-
-3. Build the project:
-   ```bash
-   npm run build
-   ```
-
-4. Run smoke tests (no Unreal needed):
-   ```bash
-   npm run test:smoke
-   ```
-
-## Development Workflow
-
-### Branch Naming
-
-Use descriptive branch names:
-- `feat/add-new-tool` - New features
-- `fix/connection-timeout` - Bug fixes
-- `docs/update-readme` - Documentation
-- `refactor/cleanup-bridge` - Code refactoring
-
-### Running Tests
-
-```bash
-# Smoke test (CI-compatible, no Unreal needed)
-npm run test:smoke
-
-# Live tests (requires Unreal Editor running with plugin)
-npm run test:all
-```
-
-### Building
-
-```bash
-npm run build        # Full build (TypeScript + WASM)
-npm run build:core   # TypeScript only
-npm run build:wasm   # WASM only (requires wasm-pack)
-```
-
-## Pull Request Process
-
-### Before Submitting
-
-1. ✅ Run `npm run lint` and fix any issues
-2. ✅ Run `npm run test:smoke` to verify basic functionality
-3. ✅ Update documentation if adding new features
-4. ✅ Update `CHANGELOG.md` under `[Unreleased]`
-
-### PR Title Format
-
-We use [Conventional Commits](https://www.conventionalcommits.org/). PR titles must follow this format:
-
-```
-<type>: <description>
-
-Examples:
-feat: add new animation blending tool
-fix: resolve WebSocket connection timeout
-docs: update installation instructions  
-refactor: simplify blueprint graph handler
-```
-
-**Types:** `feat`, `fix`, `docs`, `style`, `refactor`, `perf`, `test`, `build`, `ci`, `chore`, `revert`
-
-### Review Process
-
-1. All PRs require at least one approval
-2. CI must pass (lint, smoke test, CodeQL)
-3. Maintainers may request changes
-
-## Coding Standards
-
-### TypeScript
-
-- Use strict TypeScript (`strict: true`)
-- Prefer `async/await` over raw Promises
-- Use descriptive variable names
-- Add JSDoc comments for public APIs
-
-### C++ (Plugin)
-
-- Follow Unreal Engine coding standards
-- Use `UPROPERTY`/`UFUNCTION` macros appropriately
-- Keep thread safety in mind for async operations
-
-### File Organization
-
-```
-src/
-├── tools/           # MCP tool implementations
-├── automation/      # Unreal bridge logic
-├── utils/           # Shared utilities
-└── services/        # Background services
-
-Plugins/
-└── McpAutomationBridge/  # C++ Unreal plugin
-```
-
-## Questions?
-
-- Open a [Discussion](../../discussions) for questions
-- Open an [Issue](../../issues) for bugs or feature requests
-
-Thank you for contributing! 🎮

package/Dockerfile

@@ -1,37 +0,0 @@
-# Multi-stage build for efficient image size
-FROM node:22-alpine AS builder
-
-# Set working directory
-WORKDIR /app
-
-# Copy package files
-COPY package*.json ./
-
-# Install ALL dependencies (including dev) for building - skip prepare script
-RUN npm ci --ignore-scripts
-
-# Copy TypeScript config and source files
-COPY tsconfig.json ./
-COPY src ./src
-
-# Build the TypeScript project
-RUN npm run build
-
-# Production stage
-FROM cgr.dev/chainguard/node:latest
-
-ENV NODE_ENV=production
-
-# Chainguard node runs as nonroot by default (user: node)
-WORKDIR /app
-
-# Copy only package manifests and install production deps in a clean layer
-COPY --chown=node:node package*.json ./
-RUN npm ci --omit=dev --ignore-scripts && npm cache clean --force
-
-# Copy built application from builder stage
-COPY --chown=node:node --from=builder /app/dist ./dist
-
-# No shell, no init needed; run as provided nonroot user
-ENTRYPOINT ["/usr/bin/node"]
-CMD ["dist/cli.js"]