你的经纪人手和眼睛都在运行的Flutter应用上。

Marionette 将 Claude 代码、光标、Codex、Gemini CLI、Copilot 或任何 MCP 客户端连接到你在调试模式下运行的 Flutter 应用。代理看到屏幕，点击、输入、滚动、读取日志、热加载并写一份报告。如果你了解 Playwright MCP：这就是 Flutter 的版本。

网站****文档视频 ·文章

快速开始

1. 将包添加到你的应用中，并在调试构建中初始化绑定：

2. 给你的代理设置桥接器：MCP服务器或marionette CLI，随你偏好（每个代理）：

3. 运行应用时使用 flutter run 并粘贴它打印的 ws://…/ws 虚拟机服务 URI 到提示符中，或者让代理运行应用本身：

连接 ws://127.0.0.1:9101/…/ws。在个人资料中，格式错误的邮件必须显示错误并保持提交功能被禁用，且提交必须是有效的。

[!重要] Flutter 自己的小部件可以按原样运行。自定义设计系统只需一步配置，否则代理无法看到你的按钮和字段：详见配置。

代理人能做什么

Marionette MCP

Your agent’s hands and eyes on a running Flutter app.

Marionette connects Claude Code, Cursor, Codex, Gemini CLI, Copilot or any MCP client to the Flutter app you run in debug mode. The agent sees the screen, taps, types, scrolls, reads the logs, hot reloads, and writes a report of what it did. If you know Playwright MCP: this is that, for Flutter.

Website · Docs · Video · Article

Quick start

1. Add the package to your app and initialize the binding in debug builds:

   flutter pub add marionette_flutter
   

   void main() {
     if (kDebugMode) {
       MarionetteBinding.ensureInitialized();
     } else {
       WidgetsFlutterBinding.ensureInitialized();
     }
     runApp(const MyApp());
   }
   

2. Give your agent a bridge: the MCP server or the marionette CLI, whichever you prefer (every agent):

   # MCP server, registered with Claude Code
   dart pub global activate marionette_mcp
   claude mcp add --transport stdio marionette -- marionette_mcp
   
   # or the CLI
   dart pub global activate marionette_cli
   

3. Run the app with flutter run and paste the ws://…/ws VM service URI it prints into the prompt, or ask the agent to run the app itself:

   Connect to ws://127.0.0.1:9101/…/ws. On Profile, a malformed email must show an error and keep Submit disabled, and a valid one must submit.

[!IMPORTANT] Flutter’s own widgets work as is. A custom design system needs one configuration step, or the agent cannot see your buttons and fields: see Configure.

What the agent can do