Arenukvern/mcp_flutter

해결하는 문제

flutter-mcp-toolkit은 AI 에이전트(Claude Code, Cursor, Zed 등)가 실행 중인 Flutter 애플리케이션과 상호 작용하고 제어할 수 있는 방법을 제공합니다. AI 어시스턴트가 결과를 확인하지 못한 채 앱 상태를 추측하거나 수동으로 코드를 수정할 필요가 없도록 하여, 에이전트와 실행 중인 소프트웨어 간의 폐쇄형 피드백 루프를 구축합니다.

작동 원리

이 프로젝트는 Dart MCP 서버와 Flutter 패키지로 구성됩니다. 툴킷을 Flutter 앱에 추가하고 디버그 모드에서 실행하면, AI 에이전트가 Model Context Protocol (MCP)을 통해 앱에 연결할 수 있습니다. 툴킷은 일련의 도구(fmt_* 접두사 사용)를 노출하여 에이전트가 의미론적 스냅샷 찍기, 위젯 탭하기, 폼에 입력하기, 핫 리로드 트리거하기와 같은 작업을 수행할 수 있도록 합니다.

또한, 이 툴킷은 Dynamic Tools Registration을 지원하여 개발자가 Flutter 앱 내에서 직접 사용자 정의 MCP 도구와 리소스를 정의하고, AI 에이전트가 런타임에 이를 사용할 수 있도록 합니다.

대상 사용자

AI 에이전트에게 실행 중인 애플리케이션에 대한 직접적인 제어 권한을 부여하여 디버깅, 테스트 및 UI 개발을 자동화하려는 Flutter 개발자.

주요 특징

• 직접적인 앱 제어: 에이전트가 실행 중인 앱 내에서 탭, 스크롤, 입력 및 탐색을 수행할 수 있습니다.
• 심층 검사: 의미론적 스냅샷을 찍고, 로그를 읽고, Dart 표현식을 평가하는 기능을 제공합니다.
• 라이프사이클 관리: AI 채팅에서 직접 핫 리로드 및 핫 리스타트를 지원합니다.
• 동적 도구: 앱이 런타임에 자체적인 사용자 정의 MCP 도구를 등록하여 에이전트가 사용할 수 있게 합니다.
• 자동화 체인: 통합된 AutomationDriver 계약을 통해 MCP, CLI 및 프로그래밍 방식의 Dart 시나리오 전반에서 동일한 제어 어휘를 사용할 수 있습니다.