leancodepl/marionette_mcp

MCP server enabling AI agents to interact with Flutter apps at runtime - let them inspect widgets, simulate taps, enter text, scroll, and take screenshots.

解决的问题

Marionette MCP 允许 AI 代理实时与运行中的 Flutter 应用程序进行交互和测试。它弥合了 AI 推理与实时应用 UI 之间的差距,使代理能够在无需开发者手动操作应用的情况下,执行自动化烟雾测试、调查缺陷并验证功能实现。

工作原理

它使用 Model Context Protocol (MCP) 将 AI 代理(如 Claude Code、Cursor 或 Copilot)连接到以调试模式运行的 Flutter 应用。通过向 Flutter 应用添加绑定,系统会暴露一组聚焦的工具,允许代理检查组件树、执行手势操作(点击、滑动、滚动)、输入文本、截取屏幕截图并读取应用日志。

适用人群

希望使用 AI 代理自动化其移动或桌面应用程序交互与测试的 Flutter 开发者和 QA 工程师。

主要亮点

  • 运行时交互:专注于驱动实时 UI,而非开发时的代码分析。
  • 聚焦工具集:提供高信号操作(点击、滚动、输入文本),以保持 AI 上下文窗口小且提示高效。
  • 可扩展性:支持自定义扩展,向代理暴露应用特定操作(如种子测试数据或切换功能标志)。
  • 广泛代理支持:与多种 AI 工具兼容,包括 Claude Code、Gemini CLI 和 Cursor。

相关

  • 项目
  • 项目
  • 项目
  • 项目
  • 项目