mcpField
F
flutter-mcp-toolkit-maintain-macos

flutter-mcp-toolkit-maintain-macos

github.com/arenukvernDevelopment39448 installsUpdated 2w ago
Repository

About flutter-mcp-toolkit-maintain-macos

A maintenance skill for the Flutter MCP Toolkit macOS showcase, covering app launch, code generation, native IntentCall, and runtime validation. It distinguishes macOS validation from WebMCP testing.

Key features

  1. 01Launch and stop the macOS showcase
  2. 02Sync code generation across platforms
  3. 03Configure native IntentCall listening
  4. 04Validate runtime and capture images
  5. 05Check and request system permissions

Use cases

  1. 01Verify macOS VM extensions and dynamic registry
  2. 02Test invocation through intentcall:// links
  3. 03Run evaluations on both web and macOS

MCP support

The skill supports validation of MCP tools in the macOS showcase. WebMCP modelContext is web-only, so Web testing must be run separately.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/arenukvern/mcp_flutter --skill flutter-mcp-toolkit-maintain-macos

After installing, type/flutter-mcp-toolkit-maintain-macosin Claude Code to confirm it loaded.

Details

From the project README

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
TargetRole
macos/intentcall_codegen.shXcode Run Script → codegen sync --platform macos
macos/Runner.xcodeprojRun Script phase (see script comment if manual)
lib/main.dartIntentCallInvokeLinkListener 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)

Comments

Markdown supported