feat(scripts): Add serve-mcp.sh for Docker/remote MCP access

Wrapper script that launches supergateway with correct PATH (homebrew,
MacPorts, user-local) and workflow config so build-tools and other
homebrew-installed binaries are reachable from Docker containers via
Streamable HTTP.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: paul-maas

scripts/serve-mcp.sh

@@ -0,0 +1,63 @@
+#!/usr/bin/env bash
+# serve-mcp.sh — Expose the MCP server over HTTP for Docker/remote clients.
+#
+# Wraps supergateway to bridge stdio MCP to Streamable HTTP, setting the
+# correct PATH and workflow config so homebrew-installed tools (xcodegen,
+# create-dmg, etc.) are reachable from the child process.
+#
+# Usage:
+#   ./scripts/serve-mcp.sh                        # defaults: port 9090, all workflows
+#   ./scripts/serve-mcp.sh --port 8080             # custom port
+#   WORKFLOWS="build-tools,simulator" ./scripts/serve-mcp.sh  # specific workflows
+#
+# Docker client config (.mcp.json inside container):
+#   {
+#     "mcpServers": {
+#       "xcode": {
+#         "type": "http",
+#         "url": "http://host.docker.internal:<port>/mcp"
+#       }
+#     }
+#   }
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+
+# --- PATH: include common tool locations ---
+# homebrew (Apple Silicon + Intel), MacPorts, user-local
+for dir in /opt/homebrew/bin /usr/local/bin /opt/local/bin "$HOME/.local/bin"; do
+  [[ -d "$dir" ]] && [[ ":$PATH:" != *":$dir:"* ]] && PATH="$dir:$PATH"
+done
+export PATH
+
+# --- Workflows ---
+# Default: all workflows. Override with WORKFLOWS env var.
+if [[ -z "${XCODEBUILDMCP_ENABLED_WORKFLOWS:-}" ]]; then
+  export XCODEBUILDMCP_ENABLED_WORKFLOWS="${WORKFLOWS:-build-tools,simulator,macos,device,doctor,workflow-discovery,project-discovery,utilities}"
+fi
+
+# --- Port ---
+PORT=9090
+prev_arg=""
+for arg in "$@"; do
+  if [[ "$prev_arg" == "--port" ]]; then
+    PORT="$arg"
+  fi
+  prev_arg="$arg"
+done
+
+# --- Launch ---
+echo "MCP server: ${PROJECT_ROOT}/build/cli.js"
+echo "Endpoint:   http://localhost:${PORT}/mcp"
+echo "Workflows:  ${XCODEBUILDMCP_ENABLED_WORKFLOWS}"
+echo "PATH includes: $(which xcodegen 2>/dev/null || echo '(xcodegen not found)'), $(which codesign 2>/dev/null || echo '(codesign not found)')"
+echo ""
+
+exec npx supergateway \
+  --port "$PORT" \
+  --stdio "node ${PROJECT_ROOT}/build/cli.js mcp" \
+  --outputTransport streamableHttp \
+  --cors \
+  "$@"