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. 01启动和停止 macOS showcase
  2. 02同步多平台代码生成
  3. 03配置原生 IntentCall 监听
  4. 04验证运行时并捕获画面
  5. 05查询和请求系统权限

适用场景

  1. 01验证 macOS VM 扩展与动态注册
  2. 02检查 intentcall:// 链接调用
  3. 03运行 Web 与 macOS 双端评测

MCP 相关

该技能帮助验证 MCP 工具在 macOS showcase 中的运行；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：从日志中 grep ws://127.0.0.1:…/ws（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.dart用于处理 intentcall://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

双平台 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