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 도구와 호환됩니다.