본문으로 건너뛰기

MCP 업무 작업 목록

다음 MCP 업무 작업은 tool_list 분류에 따라 정리했습니다. 이름은 tool_call의 tool에, 업무 매개변수는 args에 전달합니다. 전체 매개변수와 제약은 tool_info로 확인하세요. 읽기 전용 및 변경 가능 표시는 정의의 readOnly를 따릅니다.

XXT Home(XXT_HOME_PATH)은 장치에서 XXTouch가 사용하는 작업 디렉터리입니다.

장치 (devices)​

도구설명효과
backend_discover_devicesUDP 장치 검색 브로드캐스트 제출변경 가능
backend_import_device주소에 해당하는 장치 가져오기변경 가능
backend_import_devices장치 일괄 가져오기 작업 제출변경 가능
backend_list_devices등록된 장치 목록 조회읽기 전용
backend_scan_ipsIPv4 주소와 포트의 TCP 응답 확인변경 가능
backend_scan_networks중앙 제어 호스트의 IPv4 대역 목록 조회읽기 전용
device_check_authXXTouch 인증 상태 읽기읽기 전용
device_clear_app_data지정한 앱의 데이터 비우기변경 가능
device_clear_logs저장된 장치 로그 기록 비우기변경 가능
device_collect_realtime_logs장치의 실시간 스크립트 로그 읽기읽기 전용
device_delete_record중앙 제어의 장치 기록 삭제변경 가능
device_export_logs저장된 장치 로그 기록 내보내기변경 가능
device_get_app_paths앱 컨테이너, 그룹 및 플러그인 경로 읽기읽기 전용
device_get_applist장치 앱 메타데이터 목록 조회읽기 전용
device_get_status장치 한 대의 실시간 상태 읽기읽기 전용
device_get_xxtlc_logs지정 채널의 중앙 제어 로그 기록 읽기읽기 전용
device_input_sequence순서대로 터치, 키 입력 및 대기 동작 실행변경 가능
device_install_package장치의 XXTouch 갱신변경 가능
device_list_apps설치된 앱과 식별자 목록 조회읽기 전용
device_lock장치 화면 잠금 요청변경 가능
device_package_update_statusAndroid Root의 XXTouch 업데이트 진행 상태 읽기읽기 전용
device_reboot장치 재부팅 요청변경 가능
device_respringSpringBoard 재시작 요청변경 가능
device_set_brightness장치 밝기 설정변경 가능
device_set_volume장치 음량 설정변경 가능
device_trollstore_installTrollStore를 통한 IPA/TIPA 설치 요청변경 가능
device_ui_element_action지정한 UI 요소에 대한 동작 실행변경 가능
device_ui_element_query조건 또는 좌표에 해당하는 UI 요소 읽기읽기 전용
device_ui_element_snapshotUI 요소, 경계와 터치 가능 여부 읽기읽기 전용
device_unlock장치 화면 잠금 해제 요청변경 가능

그룹 (groups)​

도구설명효과
backend_group_add_devices그룹 구성원 추가변경 가능
backend_group_create장치 그룹 생성변경 가능
backend_group_delete장치 그룹 삭제변경 가능
backend_group_delete_script_config지정 스크립트의 그룹 설정 삭제변경 가능
backend_group_get_script_config지정 스크립트의 그룹 설정 읽기읽기 전용
backend_group_list장치 그룹 목록 조회읽기 전용
backend_group_list_script_configs그룹에 저장된 스크립트 설정 목록 조회읽기 전용
backend_group_remove_devices그룹 구성원 제거변경 가능
backend_group_rename장치 그룹 이름 변경변경 가능
backend_group_reorder장치 그룹 순서 변경변경 가능
backend_group_set_script그룹에 연결된 스크립트 설정변경 가능
backend_group_set_script_config지정 스크립트의 그룹 설정 전체 교체변경 가능

스크립트 (scripts)​

도구설명효과
backend_list_scripts중앙 제어의 실행 가능한 스크립트 목록 조회읽기 전용
backend_read_script중앙 제어 스크립트의 UTF-8 내용 읽기읽기 전용
backend_write_script중앙 제어 스크립트의 UTF-8 내용 쓰기 또는 덮어쓰기변경 가능
device_get_selected_script장치에서 선택한 스크립트 읽기읽기 전용
device_launch_script장치의 스크립트 실행변경 가능
device_pause_script장치의 스크립트 일시 정지변경 가능
device_resume_script장치의 스크립트 재개변경 가능
device_run_script_snippet장치의 짧은 Lua 코드 실행변경 가능
device_select_script장치에서 선택한 스크립트 설정변경 가능
device_send_script_and_encrypt스크립트 또는 프로젝트의 장치 암호화 및 중앙 제어 저장 실행변경 가능
device_send_script_and_run스크립트 또는 프로젝트 전송 및 시작 실행변경 가능
device_stop_script장치의 스크립트 중지변경 가능
device_upload_script중앙 제어 스크립트의 장치 업로드 실행변경 가능

파일 (files)​

도구설명효과
backend_file_copy중앙 제어 파일 또는 디렉터리 복사변경 가능
backend_file_delete중앙 제어 파일 또는 디렉터리 삭제변경 가능
backend_file_exists중앙 제어 파일 또는 디렉터리 확인읽기 전용
backend_file_hash중앙 제어 파일 체크섬 읽기읽기 전용
backend_file_list중앙 제어 파일 또는 디렉터리 목록 조회읽기 전용
backend_file_mkdir중앙 제어 디렉터리 생성변경 가능
backend_file_move중앙 제어 파일 또는 디렉터리 이동변경 가능
backend_file_read중앙 제어 파일 내용 읽기읽기 전용
backend_file_rename중앙 제어 파일 또는 디렉터리 이름 변경변경 가능
backend_file_write중앙 제어 파일 내용 쓰기 또는 덮어쓰기변경 가능
device_root_file_copy장치 절대 경로의 파일 또는 디렉터리 복사변경 가능
device_root_file_list장치 절대 경로의 파일 또는 디렉터리 목록 조회읽기 전용
device_root_file_mkdir장치 절대 경로 디렉터리 생성변경 가능
device_root_file_move장치 절대 경로의 파일 또는 디렉터리 이동변경 가능
device_root_file_remove장치 절대 경로의 파일 또는 디렉터리 삭제변경 가능
device_root_file_save_to_backend장치 절대 경로 파일의 중앙 제어 저장 실행변경 가능
device_root_file_stat장치 절대 경로의 파일 메타데이터 읽기읽기 전용
device_xxt_home_file_copyXXT Home 내 파일 또는 디렉터리 복사변경 가능
device_xxt_home_file_listXXT Home 내 파일 또는 디렉터리 목록 조회읽기 전용
device_xxt_home_file_mkdirXXT Home 내 디렉터리 생성변경 가능
device_xxt_home_file_moveXXT Home 내 파일 또는 디렉터리 이동변경 가능
device_xxt_home_file_readXXT Home 내 파일 내용 읽기읽기 전용
device_xxt_home_file_removeXXT Home 내 파일 삭제변경 가능
device_xxt_home_file_rmdirXXT Home 내 빈 디렉터리 삭제변경 가능
device_xxt_home_file_writeXXT Home 내 파일 내용 쓰기 또는 덮어쓰기변경 가능
device_xxt_home_save_file_to_backendXXT Home의 파일 또는 디렉터리를 중앙 제어 서버의 디렉터리에 저장변경 가능
device_xxt_home_send_files중앙 제어 서버의 파일 또는 디렉터리를 장치의 XXT Home으로 전송변경 가능

이미지 (images)​

도구설명효과
backend_binarize_image이미지 이진화 및 저장 실행변경 가능
backend_crop_image이미지 사각형 자르기 및 저장 실행변경 가능
backend_extract_matrix단일 글리프 점 행렬 추출 및 이미지 저장 실행변경 가능
backend_fit_binary_selection이진 내용 선택 영역의 맞춤 조정 실행읽기 전용
backend_matrix_line_from_binary_image이진 이미지의 MatrixDict 행 변환 실행읽기 전용
backend_pick_image_colors지정 이미지 픽셀의 색상 읽기읽기 전용
backend_split_matrix빈 열을 기준으로 글리프 스트립 행렬 분리 실행읽기 전용
backend_view_image중앙 제어 저장소의 이미지 미리보기 읽기읽기 전용
device_get_screen_size물리 화면 크기와 좌표 변환 읽기읽기 전용
device_get_screenshot장치 스크린샷과 좌표 정보 읽기읽기 전용

데이터 (data)​

도구설명효과
backend_kvdb_dict_clearKVDB 사전 항목 비우기변경 가능
backend_kvdb_dict_createKVDB 사전 생성변경 가능
backend_kvdb_dict_delete_allKVDB 사전 삭제변경 가능
backend_kvdb_dict_delete_key단일 KVDB 사전 키 삭제변경 가능
backend_kvdb_dict_delete_keys선택한 KVDB 사전 키 삭제변경 가능
backend_kvdb_dict_get단일 KVDB 사전 값 읽기읽기 전용
backend_kvdb_dict_get_allKVDB 사전 항목 목록 조회읽기 전용
backend_kvdb_dict_incr사전 내 정수 문자열 원자적 증가변경 가능
backend_kvdb_dict_put단일 KVDB 사전 값 쓰기 또는 덮어쓰기변경 가능
backend_kvdb_dict_renameKVDB 사전 이름 변경변경 가능
backend_kvdb_dict_replaceKVDB 사전 항목 전체 교체변경 가능
backend_kvdb_dict_upsertKVDB 사전 항목 병합 쓰기변경 가능
backend_kvdb_export전체 KVDB의 SQLite 백업 내보내기변경 가능
backend_kvdb_import전체 KVDB의 SQLite 백업 가져오기변경 가능
backend_kvdb_list_dictsKVDB 사전 목록 조회읽기 전용
backend_kvdb_list_queuesKVDB 큐 목록 조회읽기 전용
backend_kvdb_queue_clearKVDB 큐 값 비우기변경 가능
backend_kvdb_queue_countKVDB 큐 값 개수 조회읽기 전용
backend_kvdb_queue_createKVDB 큐 생성변경 가능
backend_kvdb_queue_delete_allKVDB 큐 삭제변경 가능
backend_kvdb_queue_delete_indices지정 위치의 큐 항목 삭제변경 가능
backend_kvdb_queue_listKVDB 큐 값 목록 조회읽기 전용
backend_kvdb_queue_moveKVDB 큐 간 원자적 전송 실행변경 가능
backend_kvdb_queue_popKVDB 큐 값 큐에서 꺼내 반환변경 가능
backend_kvdb_queue_pushKVDB 큐 값 큐에 넣기변경 가능
backend_kvdb_queue_renameKVDB 큐 이름 변경변경 가능
backend_kvdb_queue_replaceKVDB 큐 값 전체 교체변경 가능
backend_tabledb_add_columnsTableDB 사용자 열 추가변경 가능
backend_tabledb_add_rowsTableDB 데이터 행 추가변경 가능
backend_tabledb_count_rows조건에 맞는 TableDB 행 개수 조회읽기 전용
backend_tabledb_createTableDB 테이블 생성변경 가능
backend_tabledb_delete_rowsTableDB 데이터 행 삭제변경 가능
backend_tabledb_delete_tableTableDB 테이블 삭제변경 가능
backend_tabledb_drop_columnsTableDB 사용자 열 삭제변경 가능
backend_tabledb_edit_rowsTableDB 데이터 행 갱신변경 가능
backend_tabledb_exportTableDB 데이터 행 내보내기변경 가능
backend_tabledb_export_all전체 TableDB의 SQLite 백업 내보내기변경 가능
backend_tabledb_export_selection선택한 TableDB 행과 열 내보내기변경 가능
backend_tabledb_fetch_one단일 행 원자적 조회 및 선택적 갱신 실행변경 가능
backend_tabledb_get_row지정 ID의 TableDB 행 읽기읽기 전용
backend_tabledb_get_schemaTableDB 테이블 구조 읽기읽기 전용
backend_tabledb_importTableDB 데이터 행 가져오기변경 가능
backend_tabledb_import_all전체 TableDB의 SQLite 백업 가져오기변경 가능
backend_tabledb_list_rowsTableDB 데이터 행 목록 조회읽기 전용
backend_tabledb_list_tablesTableDB 테이블 목록 조회읽기 전용
backend_tabledb_rename_columnTableDB 사용자 열 이름 변경변경 가능
backend_tabledb_rename_tableTableDB 테이블 이름 변경변경 가능
backend_tabledb_reorder_columnsTableDB 열 순서 설정변경 가능
backend_tabledb_truncateTableDB 데이터 행 비우기변경 가능

예약 작업 (schedules)​

도구설명효과
backend_schedule_cancel_run단일 예약 실행 취소변경 가능
backend_schedule_create예약 작업 정의 생성변경 가능
backend_schedule_delete예약 작업 삭제변경 가능
backend_schedule_export예약 작업 JSON 백업 내보내기읽기 전용
backend_schedule_get예약 작업 정의 읽기읽기 전용
backend_schedule_import예약 작업 JSON 백업 가져오기변경 가능
backend_schedule_list예약 작업 목록 조회읽기 전용
backend_schedule_list_runs예약 실행 기록과 상태 목록 조회읽기 전용
backend_schedule_run단일 예약 실행 제출변경 가능
backend_schedule_set_enabled예약의 자동 트리거 상태 설정변경 가능
backend_schedule_update예약 작업 정의 전체 교체변경 가능
backend_schedule_validate예약 작업 정의 정적 검증 및 정규화읽기 전용

백그라운드 작업 (tasks)​

도구설명효과
backend_batch_authorize_continue일괄 인증 작업 재개변경 가능
backend_batch_authorize_pause일괄 인증 작업 일시 정지변경 가능
backend_batch_authorize_start일괄 인증 작업 제출변경 가능
backend_batch_execute장치 일괄 작업 제출변경 가능
backend_task_cancel백그라운드 작업 취소 요청변경 가능
backend_task_get백그라운드 작업 상태와 요약 읽기읽기 전용
backend_task_list지정 출처의 백그라운드 작업 목록 조회읽기 전용
backend_task_results백그라운드 작업 개별 결과 읽기읽기 전용
backend_task_retry종료된 Agent 작업의 실패 항목 재시도변경 가능

IDE 세션 (ide)​

도구설명효과
ide_bind_session현재 MCP 연결의 IDE 세션 바인딩 설정변경 가능
ide_get_bound_session현재 MCP 연결의 IDE 세션 바인딩 읽기읽기 전용
ide_get_contextIDE 작업 공간, 파일 및 선택 컨텍스트 읽기읽기 전용
ide_list_sessions활성 IDE 세션 목록 조회읽기 전용
ide_resolve_selected_deviceIDE에서 선택한 장치 읽기읽기 전용

사용자 지원 (assist)​

도구설명효과
xxt_assist_cancel_task사용자 지원 작업 취소변경 가능
xxt_assist_create_task사용자 지원 작업 생성변경 가능
xxt_assist_get_task사용자 지원 작업의 상태와 결과 읽기읽기 전용
xxt_assist_list_tasks사용자 지원 작업 목록 조회읽기 전용
xxt_assist_wait_result사용자 지원 결과 대기 요청읽기 전용

시스템 (system)​

도구설명효과
backend_get_app_config공개된 타입 기반 앱 설정 읽기읽기 전용
backend_get_config단일 문자열 설정 항목 읽기읽기 전용
backend_health중앙 제어 서비스 가용성 확인읽기 전용
backend_rename_devices장치 이름과 중앙 제어 기록 갱신변경 가능
backend_set_app_config공개된 타입 기반 앱 설정 갱신변경 가능
backend_set_config단일 문자열 설정 항목 설정변경 가능
backend_version중앙 제어 백엔드 버전 읽기읽기 전용