MCP Appium Server

MCP Appium 서버

Appium을 사용한 모바일 앱 자동화를 위한 MCP(Model Context Protocol) 서버 구현.

필수 조건

1. Node.js(v14 이상)
2. 자바 개발 키트(JDK)
3. Android SDK(Android 테스트용)
4. Xcode(iOS 테스트용, macOS 전용)
5. Appium 서버
6. Android 기기 또는 에뮬레이터 / iOS 기기 또는 시뮬레이터

설정

1. 종속성 설치:

지엑스피1

2. Appium 서버를 설치하고 시작하세요:

3. Android 기기/에뮬레이터 설정:
   • Android 기기에서 개발자 옵션 활성화
   • USB 디버깅 활성화
   • USB를 통해 장치를 연결하거나 에뮬레이터를 시작하세요
   • adb devices 사용하여 장치가 연결되었는지 확인하세요.

테스트 실행

1. 프로젝트를 빌드하세요:

2. MCP 서버를 시작합니다.

3. 새 터미널에서 테스트를 실행하세요.

테스트 구성

예제 테스트에서는 Android 설정 앱을 데모로 사용합니다. 직접 앱을 테스트하려면 다음 단계를 따르세요.

1. examples/appium-test.ts 편집:
   • 장치와 일치하도록 deviceName 업데이트하세요.
   • APK 파일에 app 경로를 설정하거나
   • 설치된 앱의 appPackage 및 appActivity 업데이트
2. 일반적인 기능 구성:

사용 가능한 작업

MCP 서버는 다양한 Appium 작업을 지원합니다.

1. 요소 상호작용:
   • 요소 찾기
   • 탭/클릭
   • 텍스트를 입력하세요
   • 요소로 스크롤
   • 길게 누르기
2. 앱 관리:
   • 앱 실행/종료
   • 앱 재설정
   • 현재 패키지/활동 가져오기
3. 장치 제어:
   • 화면 방향
   • 키보드 취급
   • 기기 잠금/잠금 해제
   • 스크린샷
   • 배터리 정보
4. 고급 기능:
   • 컨텍스트 전환(네이티브/웹뷰)
   • 파일 작업
   • 알림
   • 사용자 정의 제스처

문제 해결

1. 장치를 찾을 수 없습니다:
   • adb devices 출력 확인
   • USB 디버깅이 활성화되어 있는지 확인하세요
   • 장치를 다시 연결해보세요
2. 앱이 설치되지 않음:
   • APK 경로가 올바른지 확인하세요
   • 장치에 충분한 저장 공간이 있는지 확인하세요
   • 앱이 디버그용으로 서명되었는지 확인하세요
3. 찾을 수 없는 요소:
   • Appium Inspector를 사용하여 선택기 확인
   • 화면에 요소가 보이는지 확인하세요
   • 다양한 위치 전략을 시도해 보세요
4. 연결 문제:
   • Appium 서버가 실행 중인지 확인하세요
   • 포트 충돌 확인
   • 올바른 기능이 설정되었는지 확인하세요

기여하다

추가 기능이나 버그 수정에 대한 문제점과 풀 리퀘스트를 자유롭게 제출하세요.

특허

MIT