mcpField
F
flutter-mcp-toolkit-maintain-macos

flutter-mcp-toolkit-maintain-macos

github.com/arenukvern開発39448 回インストール2 週間前に更新
リポジトリ

flutter-mcp-toolkit-maintain-macos について

Flutter MCP Toolkit の macOS showcase を保守するためのスキルです。アプリの起動、コード生成、ネイティブ IntentCall、ランタイム検証を扱い、macOS と WebMCP の検証範囲を区別します。

主な機能

  1. 01macOS showcase の起動と停止
  2. 02複数プラットフォームのコード生成同期
  3. 03ネイティブ IntentCall リスナーの設定
  4. 04ランタイム検証と画像キャプチャ
  5. 05システム権限の確認と要求

活用シーン

  1. 01macOS VM 拡張と動的レジストリの検証
  2. 02intentcall:// リンク経由の呼び出し確認
  3. 03Web と macOS 両方での評価実行

MCP 対応

macOS showcase で MCP ツールを検証する手順を提供します。WebMCP の modelContext は Web 専用のため、Web のテストは別途実施します。

インストール

コマンドをコピーしてターミナルで実行します。

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

インストール後、Claude Code で/flutter-mcp-toolkit-maintain-macosを入力して読み込まれたか確認します。

詳細

macOS のメンテナンス（ショーケース＋ネイティブの intentcall）

Dogfood アプリ：showcase/flutter_test_app。プラットフォームのドキュメント：showcase/flutter_test_app/INTENTCALL_PLATFORM.md。

macOS での WebMCP

WebMCP の modelContext は Web 専用です。 macOS の dogfood では、VM 拡張機能、動的レジストリ、ネイティブ呼び出し（app_links 経由の intentcall://）、画面キャプチャ（ホストでの画面収録）を検証します。

WebMCP との同等性を評価するには、Web のイテレーションを別途実行してください（flutter-mcp-toolkit-maintain-web）。

ショーケースの起動

make showcase-stop && make showcase
  • ログ：.showcase/flutter_app.log
  • WS URI：ログから ws://127.0.0.1:…/ws を grep します（VM のデフォルトポートは 8181）
grep -Eo 'ws://127\.0\.0\.1:[0-9]+/[A-Za-z0-9_=-]+/ws' .showcase/flutter_app.log | tail -1

停止：make showcase-stop。

コード生成とフック

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
対象役割
macos/intentcall_codegen.shXcode の Run Script → codegen sync --platform macos
macos/Runner.xcodeprojRun Script フェーズ（手動で行う場合はスクリプトのコメントを参照）
lib/main.dartintentcall://invoke/… 用の IntentCallInvokeLinkListener

ランタイムの検証

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

権限（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

2 プラットフォームでの dogfood

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

関連項目

  • flutter-mcp-cli-runtime-validation — doctor、キャプチャバックエンド、拡張機能
  • flutter-mcp-toolkit-maintain-web — WebMCP の有効化
  • flutter-mcp-toolkit-dogfood-iterations — 評価基準＋トラッカー
  • flutter-mcp-e2e-harness — このショーケースでのプログラムによるシナリオ（packages/harness、ショーケースランチャー）

コメント

Markdown 対応