leancodepl/marionette_mcp

解决的问题

Marionette MCP 允许 AI 代理（如 Claude Code、Cursor 和 Copilot）与运行中的 Flutter 应用程序进行交互并进行测试。它弥补了 AI 编写代码的能力与其实际操作实时应用程序以验证代码是否按预期运行之间的差距，从而实现自动化的 AI 驱动冒烟测试和交互。

运作原理

它使用模型上下文协议 (MCP) 将 AI 代理连接到处于调试模式的运行中 Flutter 应用程序。通过将绑定包 (marionette_flutter) 添加到应用程序中，代理可以访问一组精简且高信号的工具，以检查组件树 (widget tree)、执行手势（点击、滑动、滚动）、输入文本以及截取屏幕截图。它还可以读取日志并触发热重载 (hot reload)。

适用对象

希望使用 AI 代理来自动化测试、调试和验证其移动或桌面应用程序的 Flutter 开发人员。

特色亮点

• 运行时交互： 专注于驱动实时应用程序，而非开发时期的代码分析。
• 精简工具集： 提供最少量的操作（点击、滚动、文本输入），以保持 AI 上下文大小在可控范围内。
• 自定义扩展： 允许开发人员通过自定义扩展将应用程序特定的操作暴露给代理。
• 代理技能： 包含一个 SKILL.md 文件，教导 AI 代理如何设置和驱动应用程序，而无需将完整的 README 放入上下文中。
• 广泛兼容性： 支持多种 AI 工具，包括 Claude Code、Cursor、Gemini CLI 和 GitHub Copilot。