AI 기반 개발을 위한 Flutter Inspector MCP 서버

GitHub 저장소

🔍 Cursor, Claude, Cline, Windsurf, RooCode 또는 MCP 서버를 지원하는 다른 AI 어시스턴트와 같은 AI 코딩 어시스턴트와 Flutter 앱을 연결하는 MCP(Model Context Protocol) 서버

macOS에서 커서를 사용하여 MCP 서버를 설정하는 방법에 대한 간단한 비디오 튜토리얼을 시청하세요 - https://www.youtube.com/watch?v=NBY2p7XIass

[!NOTE] 현재 클라이언트에게 Dart 툴링 개발 도구 작업을 공개하는 새로운 실험적 패키지가 개발 중이므로 앞으로는 이 프로젝트가 그렇게 많이 필요하지 않을 수도 있습니다.
그러므로 현재 내 초점은 다음과 같습니다.
개발에 유용한 도구만 안정화하고 다듬는 방법(플러그 앤 플레이 방식이 더 편리해짐) 에 대한 자세한 내용은 MCP_RPC_DESCRIPTION.md에서 확인하세요.
전달 서버를 사용하지 않기 위한 해결 방법을 찾으세요.
귀하에게 유용할 것으로 바랍니다.
좋은 하루 되세요!

현재 Flutter는 포워딩 서버를 통해 MCP 서버와 함께 작동합니다. 자세한 내용은 아키텍처를 참조하세요.

⚠️ 경고 ⚠️

덤프 RPC 메서드(예: dump_render_tree )는 엄청난 양의 토큰 사용이나 컨텍스트 오버로드를 유발할 수 있습니다. 따라서 기본적으로 비활성화되어 있지만, 환경 변수 DUMPS_SUPPORTED=true 를 통해 활성화할 수 있습니다.

.env.example 에서 환경 변수에 대한 자세한 내용을 확인하세요.

🚀 시작하기

빠른 시작은 QUICK_START.md 에서 사용할 수 있습니다.
구성 옵션은 CONFIGURATION.md 에서 사용할 수 있습니다.

🎯 AI 에이전트에 사용 가능한 도구

오류 분석

get_app_errors [리소스|도구] - Flutter 앱에서 정확하고 요약된 오류 정보를 검색합니다. 사용법 :
- 오류에 대한 간략한 설명만 사용합니다. 에이전트 컨텍스트 창에 동일한 오류가 너무 많이 표시되는 것을 방지하기 위해 중복 오류를 필터링해야 합니다.
- Error Monitor를 사용하여 Dart VM 오류를 캡처합니다. 즉, 먼저 MCP 서버와 포워딩 서버를 시작하고, 앱을 시작하고, DevTools와 확장 프로그램을 연 다음, 앱을 다시 로드하여 오류를 캡처합니다. 모든 오류는 DevTools 확장 프로그램(mcp_bridge)에서 캡처됩니다.
테스트 대상 : ✅ macOS, ✅ iOS 테스트 대상 아님 : 🚧 Android, 🤔 Windows, 🤔 Linux, ❌ 웹 문제 참조

개발 도구

hot_reload [도구] - Flutter 애플리케이션의 핫 리로드를 수행합니다. 테스트 대상 : ✅ macOS, ✅ iOS, ✅ Android 테스트하지 않은 대상 : 🤔 Windows, 🤔 Linux, ❌ 웹 문제 참조
screenshot [리소스|도구] - 실행 중인 애플리케이션의 스크린샷을 캡처합니다. 구성 :
- --images 플래그 또는 IMAGES_SUPPORTED=true 환경 변수로 활성화
- 이미지 크기를 최적화하기 위해 압축을 사용할 수 있습니다.
테스트 대상 : ✅ macOS, ✅ iOS 테스트 대상 아님 : 🚧 Android, 🤔 Windows, 🤔 Linux, ❌ 웹 문제 참조

포트를 지정하지 않으면 모든 도구는 기본적으로 8181 포트를 사용합니다. 특정 포트 번호를 제공하여 이 포트를 재정의할 수 있습니다.

📚 자세한 내용은 MCP_RPC_DESCRIPTION 에서 확인하세요.

🔧 문제 해결

get_app_errors - 오류는 DevTools 확장 프로그램에서 캡처되므로 MCP 서버, 전달 서버 및 DevTools mcp_bridge 확장 프로그램을 시작한 후 Flutter 앱을 다시 시작하거나 다시 로드했는지 확인해야 합니다.

또한 다음 사항을 확인하세요.

전달 서버가 실행 중인지 확인하세요.
브라우저에서 Devtools를 열었습니다.
Flutter 앱 개발 종속성에 MCP 확장 기능을 추가하고 Devtools에서 활성화했습니다.
연결 문제
- Flutter 앱이 디버그 모드에서 실행 중인지 확인하세요.
- Flutter 앱과 검사기 모두에서 포트 일치를 확인하세요.
- 다른 프로세스에서 포트를 사용하고 있지 않은지 확인하세요
AI 도구가 Inspector를 감지하지 못함
- 구성 변경 후 AI 도구를 다시 시작합니다.
- 구성 JSON 구문을 확인하세요
- 연결 오류가 있는지 도구 로그를 확인하세요.

🚧 Smithery 통합 🚧 (작업 진행 중)

Flutter Inspector는 Smithery 레지스트리에 등록되어 있어 표준화된 인터페이스를 통해 다른 AI 도구에서 검색하고 사용할 수 있습니다.

통합 아키텍처

지엑스피1

🤝 기여하기

기여를 환영합니다! GitHub 저장소 에 풀 리퀘스트를 제출하거나 문제를 보고해 주세요.

📖 자세히 알아보기

📄 라이센스

MIT - 여러분의 프로젝트에 자유롭게 사용하세요!

플러터와 다트는 Google LLC의 상표입니다.

Flutter Inspector MCP Server

Integrations