MCP: Generate mcpb bundle

Author: drhelius

.github/workflows/geargrafx.yml

@@ -240,9 +240,87 @@ jobs:
       with:
         name: ${{ env.NAME_UPPER }}-${{ env.BUILD_NUMBER }}-bsd
         path: artifact/*
+  mcpb:
+    name: MCPB
+    needs: [macos, windows, linux]
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: write
+    strategy:
+      matrix:
+        variant:
+          - { platform: darwin, arch: arm64, os: macos-15, architecture: arm }
+          - { platform: darwin, arch: x64, os: macos-15-intel, architecture: intel }
+          - { platform: win32, arch: arm64, os: windows-latest, architecture: arm64 }
+          - { platform: win32, arch: x64, os: windows-latest, architecture: x64 }
+          - { platform: linux, arch: x64, os: ubuntu-24.04, architecture: '' }
+    steps:
+    - name: Checkout
+      uses: actions/checkout@v4
+      with:
+        fetch-depth: 0
+    - name: Get build number
+      run: |
+        echo "BUILD_NUMBER=$(git describe --abbrev=7 --dirty --always --tags)" >> $GITHUB_ENV
+    - name: Download artifact
+      uses: actions/download-artifact@v4
+      with:
+        name: ${{ env.NAME_UPPER }}-${{ env.BUILD_NUMBER }}-${{ matrix.variant.platform == 'darwin' && format('macos-{0}', matrix.variant.architecture) || matrix.variant.platform == 'linux' && matrix.variant.os || format('windows-{0}', matrix.variant.architecture) }}
+        path: download
+    - name: Prepare MCPB structure
+      run: |
+        mkdir -p mcpb/server
+        mkdir -p mcpb/mcp/resources
+
+        # Copy gamecontrollerdb.txt
+        cp download/gamecontrollerdb.txt mcpb/
+
+        # Copy MCP resources
+        cp -r download/mcp/resources/* mcpb/mcp/resources/
+
+        # Copy binary based on platform
+        if [ "${{ matrix.variant.platform }}" = "darwin" ]; then
+          # Extract macOS app bundle
+          cd download
+          unzip -q ${{ env.NAME_UPPER }}.app.zip
+          cd ..
+          cp download/${{ env.NAME_UPPER }}.app/Contents/MacOS/${{ env.NAME_LOWER }} mcpb/server/
+        elif [ "${{ matrix.variant.platform }}" = "win32" ]; then
+          cp download/${{ env.NAME_UPPER }}.exe mcpb/server/
+          cp download/SDL2.dll mcpb/server/
+        else
+          cp download/${{ env.NAME_LOWER }} mcpb/server/
+        fi
+    - name: Create manifest.json
+      run: |
+        # Determine binary name based on platform
+        if [ "${{ matrix.variant.platform }}" = "win32" ]; then
+          BINARY_NAME="${{ env.NAME_UPPER }}.exe"
+        else
+          BINARY_NAME="${{ env.NAME_LOWER }}"
+        fi
+
+        # Copy template and replace placeholders
+        cp platforms/shared/desktop/mcp/manifest.json.template mcpb/manifest.json
+        sed -i "s/{{NAME_LOWER}}/${{ env.NAME_LOWER }}/g" mcpb/manifest.json
+        sed -i "s/{{NAME_UPPER}}/${{ env.NAME_UPPER }}/g" mcpb/manifest.json
+        sed -i "s/{{VERSION}}/${{ env.BUILD_NUMBER }}/g" mcpb/manifest.json
+        sed -i "s/{{PLATFORM}}/${{ matrix.variant.platform }}/g" mcpb/manifest.json
+        sed -i "s/{{ARCH}}/${{ matrix.variant.arch }}/g" mcpb/manifest.json
+        sed -i "s|{{BINARY_NAME}}|$BINARY_NAME|g" mcpb/manifest.json
+    - name: Create MCPB package
+      run: |
+        cd mcpb
+        zip -r ../${{ env.NAME_LOWER }}-mcp-${{ matrix.variant.platform }}-${{ matrix.variant.arch }}.mcpb *
+    - name: Archive MCPB
+      uses: actions/upload-artifact@v4
+      with:
+        name: ${{ env.NAME_UPPER }}-${{ env.BUILD_NUMBER }}-mcpb-${{ matrix.variant.platform }}-${{ matrix.variant.arch }}
+        path: ${{ env.NAME_LOWER }}-mcp-${{ matrix.variant.platform }}-${{ matrix.variant.arch }}.mcpb
   release:
     name: Release
-    needs: [linux, macos, windows, bsd]
+    needs: [linux, macos, windows, bsd, mcpb]
     if: github.event_name != 'pull_request' && startswith(github.ref, 'refs/tags/')
     runs-on: ubuntu-latest
     permissions:
@@ -263,21 +341,29 @@ jobs:
       with:
         pattern: ${{ env.NAME_UPPER }}-${{ env.BUILD_NUMBER }}-*
         path: release
-    - name: Zip directories
+    - name: Zip directories (non-MCPB)
       run: |
         cd release
         for f in *; do
-          if [ -d "$f" ]; then
+          if [ -d "$f" ] && [[ ! "$f" =~ mcpb ]]; then
             cd $f
             echo "Compressing $f"
             zip -r $f.zip *
             mv $f.zip ../
             cd ..
           fi
         done
+    - name: Move MCPB packages
+      run: |
+        cd release
+        for f in *-mcpb-*; do
+          if [ -d "$f" ]; then
+            mv $f/*.mcpb ./
+          fi
+        done
     - name: Create release
       run: |
-        gh release create ${{ github.ref_name }} ./release/*.zip \
+        gh release create ${{ github.ref_name }} ./release/*.zip ./release/*.mcpb \
           --title "${{ env.NAME_UPPER }} ${{ github.ref_name }}" \
           --draft \
           --generate-notes

platforms/shared/desktop/mcp/manifest.json.template

@@ -0,0 +1,32 @@
+{
+  "manifest_version": "0.3",
+  "name": "{{NAME_LOWER}}-mcp",
+  "display_name": "{{NAME_UPPER}} MCP Server",
+  "version": "{{VERSION}}",
+  "description": "Model Context Protocol server for {{NAME_UPPER}} PC Engine / TurboGrafx-16 emulator",
+  "long_description": "{{NAME_UPPER}} is a high-accuracy PC Engine (TurboGrafx-16) emulator with comprehensive debugging capabilities exposed through the Model Context Protocol. This MCP server allows AI assistants to debug, inspect, and control the emulator, providing tools for memory inspection, breakpoint management, register access, and hardware state monitoring.",
+  "author": {
+    "name": "Nacho Sanchez",
+    "url": "https://x.com/drhelius"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/drhelius/Geargrafx.git"
+  },
+  "homepage": "https://github.com/drhelius/Geargrafx",
+  "documentation": "https://github.com/drhelius/Geargrafx/blob/main/platforms/shared/desktop/mcp/MCP_README.md",
+  "support": "https://github.com/drhelius/Geargrafx/issues",
+  "keywords": ["emulator", "pc-engine", "turbografx-16", "debugging", "retro-gaming", "hardware-emulation"],
+  "license": "GPL-3.0",
+  "server": {
+    "type": "binary",
+    "entry_point": "server/{{BINARY_NAME}}",
+    "mcp_config": {
+      "command": "${__dirname}/server/{{BINARY_NAME}}",
+      "args": ["--mcp"]
+    }
+  },
+  "compatibility": {
+    "platforms": ["{{PLATFORM}}"]
+  }
+}