unreal-engine-mcp-server 0.4.7 → 0.5.1

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

@@ -0,0 +1,51 @@
+name-template: 'v$NEXT_PATCH_VERSION'
+tag-template: 'v$NEXT_PATCH_VERSION'
+categories:
+  - title: '🚀 Features'
+    labels:
+      - 'type/enhancement'
+      - 'feature'
+      - 'enhancement'
+  - title: '🐛 Bug Fixes'
+    labels:
+      - 'type/bug'
+      - 'bug'
+      - 'fix'
+  - title: '📚 Documentation'
+    labels:
+      - 'area/docs'
+      - 'documentation'
+  - title: '🧰 Tools'
+    labels:
+      - 'area/tools'
+      - 'tooling'
+  - title: '🔌 Plugin'
+    labels:
+      - 'area/plugin'
+  - title: '🧪 Testing'
+    labels:
+      - 'area/testing'
+      - 'test'
+  - title: '📦 Maintenance'
+    labels:
+      - 'chore'
+      - 'maintenance'
+change-template: '- $TITLE @$AUTHOR (#$NUMBER)'
+change-title-escapes: '\<*_&'
+version-resolver:
+  major:
+    labels:
+      - 'major'
+  minor:
+    labels:
+      - 'minor'
+  patch:
+    labels:
+      - 'patch'
+      - 'type/bug'
+      - 'bug'
+  default: patch
+template: |
+  ## Changes in this Release
+
+  $CHANGES

package/.github/workflows/auto-merge.yml

@@ -0,0 +1,38 @@
+name: Auto-merge Dependabot PRs
+
+on: pull_request
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  dependabot:
+    runs-on: ubuntu-latest
+    if: github.actor == 'dependabot[bot]'
+    steps:
+      - name: Dependabot metadata
+        id: metadata
+        uses: dependabot/fetch-metadata@v2
+        with:
+          github-token: "${{ secrets.GITHUB_TOKEN }}"
+
+      - name: Approve patch and minor npm updates
+        if: |
+          steps.metadata.outputs.package-ecosystem == 'npm' &&
+          (steps.metadata.outputs.update-type == 'version-update:semver-patch' || 
+           steps.metadata.outputs.update-type == 'version-update:semver-minor')
+        run: gh pr review --approve "$PR_URL"
+        env:
+          PR_URL: ${{ github.event.pull_request.html_url }}
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Enable auto-merge for npm Dependabot PRs
+        if: |
+          steps.metadata.outputs.package-ecosystem == 'npm' &&
+          (steps.metadata.outputs.update-type == 'version-update:semver-patch' || 
+           steps.metadata.outputs.update-type == 'version-update:semver-minor')
+        run: gh pr merge --auto --squash "$PR_URL"
+        env:
+          PR_URL: ${{ github.event.pull_request.html_url }}
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}

package/.github/workflows/ci.yml

@@ -0,0 +1,38 @@
+name: CI
+permissions:
+  contents: read
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  lint:
+    name: Lint (TS)
+
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
+
+      - name: Setup Node.js
+        uses: actions/setup-node@395ad3262231945c25e8478fd5baf05154b1d79f # v6.1.0
+        with:
+          node-version: '18'
+
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run ESLint (TypeScript/JavaScript)
+        run: |
+          echo "Running ESLint (fail on warnings)"
+          npx eslint . --ext .ts --max-warnings=0
+
+

package/.github/workflows/dependency-review.yml

@@ -0,0 +1,17 @@
+name: 'Dependency Review'
+on: [pull_request]
+
+permissions:
+  contents: read
+
+jobs:
+  dependency-review:
+    runs-on: ubuntu-latest
+    steps:
+      - name: 'Checkout Repository'
+        uses: actions/checkout@v6 # v4
+      - name: 'Dependency Review'
+        uses: actions/dependency-review-action@v4 # v4
+        with:
+          fail-on-severity: high
+          deny-licenses: GPL-3.0, AGPL-1.0, AGPL-3.0

package/.github/workflows/gemini-issue-triage.yml

@@ -0,0 +1,172 @@
+name: '🏷️ Gemini Issue Triage'
+
+on:
+  issues:
+    types:
+      - 'opened'
+      - 'reopened'
+  workflow_dispatch:
+    inputs:
+      issue_number:
+        description: 'Issue number to triage'
+        required: true
+        type: 'number'
+
+concurrency:
+  group: '${{ github.workflow }}-${{ github.event.issue.number || github.event.inputs.issue_number }}'
+  cancel-in-progress: true
+
+permissions:
+  contents: 'read'
+  issues: 'write'
+
+jobs:
+  triage-issue:
+    if: |-
+      github.event_name == 'workflow_dispatch' ||
+      (
+        github.event_name == 'issues' &&
+        contains(github.event.issue.labels.*.name, 'needs-triage')
+      )
+    timeout-minutes: 5
+    runs-on: 'ubuntu-latest'
+    steps:
+      - name: 'Get issue data for manual trigger'
+        id: 'get_issue_data'
+        if: github.event_name == 'workflow_dispatch'
+        uses: 'actions/github-script@v8'
+        with:
+          github-token: '${{ secrets.GITHUB_TOKEN }}'
+          script: |
+            const { data: issue } = await github.rest.issues.get({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: ${{ github.event.inputs.issue_number }},
+            });
+            core.setOutput('title', issue.title);
+            core.setOutput('body', issue.body);
+            core.setOutput('labels', issue.labels.map(label => label.name).join(','));
+            return issue;
+
+      - name: 'Checkout'
+        uses: 'actions/checkout@v6'
+
+      - name: 'Get Repository Labels'
+        id: 'get_labels'
+        uses: 'actions/github-script@v8'
+        with:
+          github-token: '${{ secrets.GITHUB_TOKEN }}'
+          script: |
+            const { data: labels } = await github.rest.issues.listLabelsForRepo({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+            });
+            // Filter to area labels
+            const areaLabels = labels.map(l => l.name).filter(n => 
+              n.startsWith('area/') || n.startsWith('tool/') || n.startsWith('type/')
+            );
+            core.setOutput('available_labels', areaLabels.join(','));
+            core.info(`Found ${areaLabels.length} area labels: ${areaLabels.join(', ')}`);
+
+      - name: Analyze Issue with Gemini
+        id: gemini_analysis
+        uses: google-github-actions/run-gemini-cli@v0 # v0
+        env:
+          GITHUB_TOKEN: ''  # No auth token for untrusted input analysis
+          ISSUE_TITLE: '${{ github.event_name == ''workflow_dispatch'' && steps.get_issue_data.outputs.title || github.event.issue.title }}'
+          ISSUE_BODY: '${{ github.event_name == ''workflow_dispatch'' && steps.get_issue_data.outputs.body || github.event.issue.body }}'
+          AVAILABLE_LABELS: '${{ steps.get_labels.outputs.available_labels }}'
+        with:
+          # Use Gemini API key only (free tier) - no Vertex AI
+          gemini_api_key: '${{ secrets.GEMINI_API_KEY }}'
+          settings: |
+            {
+              "maxSessionTurns": 10
+            }
+          prompt: |
+            ## Role
+            You are an issue triage assistant for Unreal Engine MCP Server.
+
+            ## Task
+            Analyze this GitHub issue and select the most appropriate label.
+
+            Issue Title: ${{ env.ISSUE_TITLE }}
+            Issue Body: ${{ env.ISSUE_BODY }}
+            
+            Available Labels: ${{ env.AVAILABLE_LABELS }}
+
+            ## Area Definitions
+            - area/plugin: Issues with the C++ McpAutomationBridge plugin
+            - area/server: Issues with the Node.js MCP server
+            - area/tools: Issues with specific tool implementations
+            - area/testing: Issues with tests or test infrastructure
+            - area/docs: Documentation issues
+            - type/bug: Bug reports
+            - type/enhancement: Feature requests
+            - type/question: Questions or support requests
+
+            ## Output
+            Select exactly ONE label. Output only valid JSON:
+            {"label": "area/server"}
+
+      - name: 'Apply Label'
+        if: steps.gemini_analysis.outputs.summary != ''
+        uses: 'actions/github-script@v8'
+        env:
+          ISSUE_NUMBER: '${{ github.event.issue.number || github.event.inputs.issue_number }}'
+          GEMINI_OUTPUT: '${{ steps.gemini_analysis.outputs.summary }}'
+          AVAILABLE_LABELS: '${{ steps.get_labels.outputs.available_labels }}'
+        with:
+          github-token: '${{ secrets.GITHUB_TOKEN }}'
+          script: |
+            const fs = require('fs');
+            const summary = process.env.GEMINI_OUTPUT;
+            
+            // Parse Gemini output for labels
+            let parsed = {};
+            try {
+              // Try to find JSON block
+              const match = summary.match(/```json\n([\s\S]*?)\n```/);
+              if (match) {
+                parsed = JSON.parse(match[1]);
+              } else {
+                 parsed = JSON.parse(summary);
+              }
+            } catch (e) {
+              core.warning('Failed to parse Gemini output as JSON');
+              return;
+            }
+            
+            const label = parsed.label;
+            if (!label) {
+               core.warning('No label returned from Gemini');
+               return;
+            }
+
+            const availableLabels = (process.env.AVAILABLE_LABELS || '').split(',');
+            if (!availableLabels.includes(label)) {
+              core.warning(`Label '${label}' not in available labels; skipping`);
+              return;
+            }
+            
+            const issueNumber = parseInt(process.env.ISSUE_NUMBER);
+            
+            await github.rest.issues.addLabels({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: issueNumber,
+              labels: [label]
+            });
+            core.info(`Added label '${label}' to issue #${issueNumber}`);
+            
+            // Remove needs-triage label
+            try {
+              await github.rest.issues.removeLabel({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                issue_number: issueNumber,
+                name: 'needs-triage'
+              });
+            } catch (e) {
+              if (e.status !== 404) throw e;
+            }

package/.github/workflows/greetings.yml

@@ -0,0 +1,27 @@
+name: Greetings
+
+on:
+  pull_request_target:
+    types: [opened]
+  issues:
+    types: [opened]
+
+permissions:
+  issues: write
+  pull-requests: write
+
+jobs:
+  greeting:
+    runs-on: ubuntu-latest
+    # Skip for bots and repository owner
+    if: >-
+      github.actor != 'dependabot[bot]' &&
+      github.actor != 'renovate[bot]' &&
+      github.actor != 'github-actions[bot]' &&
+      github.actor != github.repository_owner
+    steps:
+    - uses: actions/first-interaction@v3
+      with:
+        repo-token: ${{ secrets.GITHUB_TOKEN }}
+        issue-message: '👋 Thanks for opening this issue! We appreciate your feedback and report. A maintainer will check this out soon.'
+        pr-message: '👋 Thanks for your first Pull Request! We love contributions. Please ensure you have signed off your commits and followed the contribution guidelines.'

package/.github/workflows/labeler.yml

@@ -0,0 +1,17 @@
+name: "Pull Request Labeler"
+on:
+  pull_request_target:
+    types: [opened, synchronize, reopened]
+
+permissions:
+  contents: read
+  pull-requests: write
+
+jobs:
+  triage:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/labeler@v6
+      with:
+        repo-token: "${{ secrets.GITHUB_TOKEN }}"
+        sync-labels: true

package/.github/workflows/links.yml

@@ -0,0 +1,80 @@
+name: '🔗 Check Broken Links'
+
+on:
+  push:
+    branches: ['main']
+    paths:
+      - '**.md'
+      - 'docs/**'
+  pull_request:
+    branches: ['main']
+    paths:
+      - '**.md'
+      - 'docs/**'
+  schedule:
+    - cron: '0 0 * * 0'
+  workflow_dispatch:
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+permissions:
+  contents: 'read'
+  issues: 'write'
+
+jobs:
+  check-links:
+    runs-on: 'ubuntu-latest'
+    steps:
+      - name: 'Checkout'
+        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
+
+      - name: 'Check for broken links'
+        uses: lycheeverse/lychee-action@a8c4c7cb88f0c7386610c35eb25108e448569cb0 # v2.7.0
+        with:
+          args: >-
+            --verbose
+            --no-progress
+            --exclude '^https://github.com/.*/issues/new'
+            --exclude '^https://github.com/.*/compare/'
+            --exclude 'localhost'
+            --exclude '127.0.0.1'
+            --exclude 'file://'
+            --exclude 'npmjs.com'
+            --exclude 'unrealengine.com'
+            --exclude 'rustwasm.github.io'
+            --exclude 'github.com/modelcontextprotocol/sdk'
+
+            '**/*.md'
+            'docs/**'
+          fail: true
+
+      - name: 'Create issue on failure'
+        if: failure() && github.event_name == 'schedule'
+        uses: actions/github-script@ed597411d8f924073f98dfc5c65a23a2325f34cd # v8.0.0
+        with:
+          github-token: '${{ secrets.GITHUB_TOKEN }}'
+          script: |
+            const title = '🔗 Broken links detected in documentation';
+            const body = `The weekly link check found broken links in the documentation.
+            
+            Please review the [workflow run](${process.env.GITHUB_SERVER_URL}/${process.env.GITHUB_REPOSITORY}/actions/runs/${process.env.GITHUB_RUN_ID}) for details.`;
+            
+            const { data: issues } = await github.rest.issues.listForRepo({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              state: 'open',
+              labels: 'area/docs'
+            });
+            
+            const existingIssue = issues.find(i => i.title === title);
+            if (!existingIssue) {
+              await github.rest.issues.create({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                title: title,
+                body: body,
+                labels: ['area/docs', 'type/bug']
+              });
+            }

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

@@ -0,0 +1,137 @@
+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

@@ -2,31 +2,32 @@ name: Publish to MCP Registry
 
 on:
   push:
-    tags: ["v*"]  # Triggers on version tags like v1.2.0
-  workflow_dispatch:  # Allow manual triggering
+    tags: ["v*"]
+  workflow_dispatch:
 
 jobs:
   publish:
     runs-on: ubuntu-latest
     permissions:
-      id-token: write  # Required for OIDC authentication
+      id-token: write
       contents: read
 
     steps:
       - name: Checkout code
-        uses: actions/checkout@v4
+        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
 
       - name: Setup Node.js
-        uses: actions/setup-node@v4
+        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 tests
-        run: npm run test
+      - name: Run smoke tests
+        run: npm run test:smoke
         continue-on-error: true
 
       - name: Run linting
@@ -55,21 +56,26 @@ jobs:
 
       - name: Publish to npm
         run: npm publish
+        continue-on-error: true
         env:
           NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
 
       - name: Install MCP Publisher
+        if: ${{ success() }}
         run: |
           curl -L "https://github.com/modelcontextprotocol/registry/releases/download/v1.1.0/mcp-publisher_1.1.0_$(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
+        if: ${{ success() }}
         run: ./mcp-publisher login github-oidc
 
       - name: Publish to MCP Registry
+        if: ${{ success() }}
         run: ./mcp-publisher publish
 
       - name: Verify publication
+        if: ${{ always() }}
         run: |
           echo "Waiting for registry to update..."
           sleep 30

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

@@ -0,0 +1,23 @@
+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
+    steps:
+      - uses: release-drafter/release-drafter@v6.1.0 # v6.1.0
+        with:
+          config-name: release-drafter-config.yml
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}