leancodepl/marionette_mcp

何を解決するか

Marionette MCP は、AIエージェントが実行中のFlutterアプリケーションとリアルタイムで相互作用し、テストできるようにします。AIの推論とライブアプリのUIの間のギャップを埋め、開発者が手動でアプリを操作する必要なく、自動スモークテストの実行、バグの調査、機能実装の検証が可能になります。

動作方法

Model Context Protocol (MCP) を使用して、実行中のデバッグモードのFlutterアプリにAIエージェント（Claude Code、Cursor、Copilotなど）を接続します。Flutterアプリにバインディングを追加することで、エージェントがウィジェットツリーの確認、ジェスチャー（タップ、スワイプ、スクロール）、テキスト入力、スクリーンショットの取得、アプリケーションログの読み取りを行うための限定されたツールセットを提供します。

対象ユーザー

モバイルまたはデスクトップアプリの相互作用とテストをAIエージェントで自動化したいFlutter開発者およびQAエンジニア

特徴

• 実行時相互作用: 開発時コード分析ではなく、ライブUIの操作に焦点を当てます。
• 限定されたツールセット: タップ、スクロール、テキスト入力などの高信号アクションを提供し、AIのコンテキストウィンドウを小さく、プロンプトを効率的に保ちます。
• 拡張可能: アプリ固有のアクション（テストデータのシード、機能フラグの切り替えなど）をエージェントに公開するためのカスタム拡張をサポートします。
• 広範なエージェント対応: Claude Code、Gemini CLI、Cursorなど、さまざまなAIツールと互換性があります。