Arenukvern/mcp_flutter

解决的问题

flutter-mcp-toolkit 提供了一种让 AI 代理程序（如 Claude Code、Cursor 与 Zed）与运行中的 Flutter 应用程序交互并进行控制的方法。它消除了 AI 助手在无法看到结果的情况下猜测应用程序状态或手动编辑代码的需求，在代理程序与运行中的软件之间建立了一个闭环反馈。

运作原理

该项目由一个 Dart MCP 服务器与一个 Flutter 套件组成。通过将此工具包加入 Flutter 应用程序并以调试模式运行，AI 代理程序可以通过 Model Context Protocol (MCP) 连接到应用程序。该工具包公开了一组工具（以 fmt_* 为前缀），允许代理程序执行诸如截取语义快照、点击组件、输入表单以及触发热重载 (hot-reload) 等操作。

此外，该工具包支持 Dynamic Tools Registration，允许开发者直接在 Flutter 应用程序内定义自定义的 MCP 工具与资源，供 AI 代理程序在运行时使用。

适用对象

希望通过赋予 AI 代理程序对运行中应用程序的直接控制权，来自动化调试、测试与 UI 开发的 Flutter 开发者。

特色亮点

• 直接应用程序控制：代理程序可以在运行中的应用程序内进行点击、滚动、输入与导航。
• 深度检查：具备截取语义快照、读取日志以及评估 Dart 表达式的能力。
• 生命周期管理：支持直接从 AI 对话中进行热重载 (hot-reload) 与热重启 (hot-restart)。
• 动态工具支持：应用程序可以在运行时注册自己的自定义 MCP 工具供代理程序使用。
• 自动化链：统一的 AutomationDriver 契约，让相同的控制词汇能在 MCP、CLI 与程序化 Dart 场景中运作。