leancodepl/marionette_mcp

解決する課題

Marionette MCPを使用すると、AIエージェント（Claude Code、Cursor、Copilotなど）が実行中のFlutterアプリケーションと対話し、テストを行うことができます。AIがコードを書く能力と、実際にライブアプリを操作してコードが意図通りに動作するかを確認する能力の間のギャップを埋め、AI主導の自動化されたスモークテストとインタラクションを実現します。

仕組み

Model Context Protocol (MCP) を使用して、AIエージェントをデバッグモードで実行中のFlutterアプリに接続します。バインディングパッケージ (marionette_flutter) をアプリに追加することで、エージェントはウィジェットツリーの検査、ジェスチャー（タップ、スワイプ、スクロール）、テキスト入力、スクリーンショット撮影といった、高シグナルなツールセットにアクセスできるようになります。また、ログの読み取りやホットリロードのトリガーも可能です。

対象ユーザー

AIエージェントを使用して、モバイルアプリやデスクトップアプリのテスト、デバッグ、検証を自動化したいFlutter開発者。

ハイライト

• ランタイムインタラクション: 開発時のコード分析ではなく、ライブアプリの操作に焦点を当てています。
• フォーカスされたツールセット: AIのコンテキストサイズを管理しやすくするため、最小限のアクション（タップ、スクロール、テキスト入力）を提供します。
• カスタム拡張: 開発者はカスタム拡張機能を通じて、アプリ固有のアクションをエージェントに公開できます。
• エージェントスキル: SKILL.md ファイルが含まれており、README全体をコンテキストに入れなくても、AIエージェントがアプリのセットアップと操作方法を学習できるようにしています。
• 幅広い互換性: Claude Code、Cursor、Gemini CLI、GitHub Copilotなど、複数のAIツールをサポートしています。