/flutter-mcp-toolkit-maintain-macos

name: flutter-mcp-toolkit-maintain-macos
description: Maintains showcase/flutter_test_app macOS showcase, native intentcall hooks (codegen, app_links invoke), and VM MCP validation. Use when editing macOS Runner, intentcall_codegen.sh, macOS dogfood, Screen Recording capture, or comparing macOS parity to web WebMCP.

<!-- @FMT_MODE_PRELUDE -->

Maintain macOS (showcase + native intentcall)

Dogfood app: `showcase/flutter_test_app`. Platform doc: `showcase/flutter_test_app/INTENTCALL_PLATFORM.md`.

WebMCP on macOS

**WebMCP `modelContext` is web-only.** macOS dogfood proves **VM extensions**, **dynamic registry**, **native invoke** (`intentcall://` via `app_links`), and **visual capture** (Screen Recording on host).

For WebMCP parity scoring, run web iteration separately (`flutter-mcp-toolkit-maintain-web`).

Launch showcase

make showcase-stop && make showcase

• Log: `.showcase/flutter_app.log`
• WS URI: grep `ws://127.0.0.1:…/ws` from log (default VM port **8181**)

grep -Eo 'ws://127\.0\.0\.1:[0-9]+/[A-Za-z0-9_=-]+/ws' .showcase/flutter_app.log | tail -1

Stop: `make showcase-stop`.

Codegen & hooks

dart run mcp_server_dart/bin/flutter_mcp_toolkit.dart codegen sync \
  --platform web,android,ios,macos,linux,windows \
  --project-dir showcase/flutter_test_app

dart run mcp_server_dart/bin/flutter_mcp_toolkit.dart init intentcall-platform \
  --project-dir showcase/flutter_test_app --check

| Target | Role | |--------|------| | `macos/intentcall_codegen.sh` | Xcode Run Script → `codegen sync --platform macos` | | `macos/Runner.xcodeproj` | Run Script phase (see script comment if manual) | | `lib/main.dart` | `IntentCallInvokeLinkListener` for `intentcall://invoke/…` |

Runtime validate

dart run mcp_server_dart/bin/flutter_mcp_toolkit.dart --save-images \
  --output-dir .showcase/macos_iter validate-runtime \
  --target "$MACOS_WS_URI" \
  --flutter-device macos \
  --timeout-ms 45000

Permissions (host process running CLI):

dart run mcp_server_dart/bin/flutter_mcp_toolkit.dart permissions status
dart run mcp_server_dart/bin/flutter_mcp_toolkit.dart permissions request

Dual-platform dogfood

bash tool/evals/run_dogfood_eval.sh \
  --ws-uri "$WEB_WS_URI" \
  --macos --macos-ws-uri "$MACOS_WS_URI"

Related

• `flutter-mcp-cli-runtime-validation` — doctor, capture backends, extensions
• `flutter-mcp-toolkit-maintain-web` — WebMCP enablement
• `flutter-mcp-toolkit-dogfood-iterations` — rubric + tracker
• `flutter-mcp-e2e-harness` — programmatic scenarios over this showcase (`packages/harness`, showcase launcher)