Flutter Surf MCP는 클라이언트 LLMs를 통해 Flutter 애플리케이션과 상호 작용할 수 있는 MCP 서버입니다. 그것은 검사, 제어 및 Automate Flutter 응용 프로그램을 제공합니다.

특징

• VM 서비스를 통해 Flutter 애플리케이션을 실행하기 위해 연결
• 위젯 트리 상태 검색 및 검사
• 위젯을 클릭
• 입력 필드에 텍스트 입력
• 텍스트, 키 또는 유형별 위젯 찾기
• 스크롤 위젯
• customizable 매개변수를 가진 스크롤 작업을 수행합니다.
• 토글 디버그 페인트 기능

요구 사항

• 파이썬 3.7+
• VM 서비스 활성화를 통한 Flutter 애플리케이션
• UV 패키지 관리자 (또는 pip)
• MCP 지원과 Claude AI

설치

1. 저장소를 복제:

2. 의존성 설치:

구성

Claude와 Flutter Surf MCP를 사용하려면 Claude AI 설정에 다음 구성을 추가하십시오.

주의: flutter 드라이버 확장을 활성화해야 합니다:

Flutter Surf MCP

Flutter Surf MCP is a MCP server that allows interactions with Flutter applications through client LLMs. It provides tools to inspect, control, and automate Flutter applications programmatically.

Features

• Connect to running Flutter applications via VM Service
• Retrieve and inspect widget tree state
• Click on widgets
• Enter text into input fields
• Find widgets by text, key, or type
• Scroll widgets into view
• Perform scrolling actions with customizable parameters
• Toggle debug paint features

Requirements

• Python 3.7+
• A running Flutter application with VM service enabled
• UV package manager (or pip)
• Claude AI with MCP support

Installation

1. Clone the repository:

git clone https://github.com/yourusername/flutter_surf_mcp.git
cd flutter_surf_mcp

2. Install dependencies:

uv pip install -r requirements.txt

Configuration

To use Flutter Surf MCP with Claude, add the following configuration to your Claude AI settings:

{
  "mcpServers": {
      "flutter_mcp": {
          "command": "[uv_directory]",
          "args": [
              "--directory",
              "[path]/flutter_surf_mcp",
              "run",
              "flutter_surf_mcp.py"
          ]
      }
  }
}

Note: Make sure to enable the flutter driver extension:

import 'package:flutter_driver/driver_extension.dart';

void main() {
  enableFlutterDriverExtension();
  runApp(const HomeScreen());
}