leancodepl/marionette_mcp

해결하는 문제

Marionette MCP를 사용하면 AI 에이전트(Claude Code, Cursor, Copilot 등)가 실행 중인 Flutter 애플리케이션과 상호작용하고 테스트할 수 있습니다. 이는 AI가 코드를 작성하는 능력과 실제로 라이브 앱을 구동하여 코드가 의도한 대로 작동하는지 확인하는 능력 사이의 간극을 메워, AI 기반의 자동화된 스모크 테스트와 상호작용을 가능하게 합니다.

작동 원리

Model Context Protocol (MCP)을 사용하여 AI 에이전트를 디버그 모드에서 실행 중인 Flutter 앱에 연결합니다. 바인딩 패키지(marionette_flutter)를 앱에 추가하면, 에이전트는 위젯 트리 검사, 제스처 수행(탭, 스와이프, 스크롤), 텍스트 입력, 스크린샷 캡처와 같은 핵심적인 도구 세트에 접근할 수 있습니다. 또한 로그를 읽고 핫 리로드(hot reload)를 트리거할 수도 있습니다.

대상 사용자

AI 에이전트를 사용하여 모바일 또는 데스크톱 앱의 테스트, 디버깅 및 검증을 자동화하려는 Flutter 개발자.

주요 특징

• 런타임 상호작용: 개발 시점의 코드 분석이 아닌, 라이브 앱을 직접 구동하는 데 중점을 둡니다.
• 집중된 도구 세트: AI 컨텍스트 크기를 관리하기 쉽도록 최소한의 작업(탭, 스크롤, 텍스트 입력)만 제공합니다.
• 사용자 지정 확장: 개발자는 사용자 지정 확장을 통해 앱별 특정 작업을 에이전트에 노출할 수 있습니다.
• 에이전트 스킬: SKILL.md 파일이 포함되어 있어, 전체 README를 컨텍스트에 넣지 않아도 AI 에이전트가 앱 설정 및 구동 방법을 학습할 수 있습니다.
• 광범위한 호환성: Claude Code, Cursor, Gemini CLI, GitHub Copilot 등 다양한 AI 도구를 지원합니다.