Chuyển tới nội dung chính

Danh mục thao tác nghiệp vụ MCP

Các thao tác nghiệp vụ MCP dưới đây được nhóm theo danh mục tool_list. Truyền tên vào tool của tool_call, tham số nghiệp vụ trong args. Dùng tool_info để xem đầy đủ tham số và ràng buộc. Nhãn chỉ đọc và có thể thay đổi theo cờ readOnly của định nghĩa.

XXT Home (XXT_HOME_PATH) là thư mục làm việc của XXTouch trên thiết bị.

Thiết bị (devices)​

Công cụMô tảTác động
backend_discover_devicesGửi bản tin dò thiết bị UDP.Có thể thay đổi
backend_import_deviceNhập thiết bị theo địa chỉ.Có thể thay đổi
backend_import_devicesGửi tác vụ nhập thiết bị hàng loạt.Có thể thay đổi
backend_list_devicesLiệt kê thiết bị đã đăng ký.Chỉ đọc
backend_scan_ipsKiểm tra phản hồi TCP tại địa chỉ và cổng IPv4.Có thể thay đổi
backend_scan_networksLiệt kê dải IPv4 của máy trung tâm.Chỉ đọc
device_check_authĐọc trạng thái giấy phép XXTouch.Chỉ đọc
device_clear_app_dataXóa hết dữ liệu ứng dụng đã chọn.Có thể thay đổi
device_clear_logsXóa hết lịch sử nhật ký thiết bị đã lưu.Có thể thay đổi
device_collect_realtime_logsĐọc nhật ký script trực tiếp của thiết bị.Chỉ đọc
device_delete_recordXóa bản ghi thiết bị trên trung tâm.Có thể thay đổi
device_export_logsXuất lịch sử nhật ký thiết bị đã lưu.Có thể thay đổi
device_get_app_pathsĐọc đường dẫn vùng chứa, nhóm và plugin ứng dụng.Chỉ đọc
device_get_applistLiệt kê siêu dữ liệu ứng dụng thiết bị.Chỉ đọc
device_get_statusĐọc trạng thái hiện tại của một thiết bị.Chỉ đọc
device_get_xxtlc_logsĐọc nhật ký trung tâm đã lưu của kênh.Chỉ đọc
device_input_sequenceThực thi chuỗi chạm, phím và chờ theo thứ tự.Có thể thay đổi
device_install_packageCập nhật XXTouch trên thiết bị.Có thể thay đổi
device_list_appsLiệt kê ứng dụng đã cài và mã định danh.Chỉ đọc
device_lockYêu cầu khóa màn hình thiết bị.Có thể thay đổi
device_package_update_statusĐọc tiến độ cập nhật XXTouch trên Android Root.Chỉ đọc
device_rebootYêu cầu khởi động lại thiết bị.Có thể thay đổi
device_respringYêu cầu khởi động lại SpringBoard.Có thể thay đổi
device_set_brightnessĐặt độ sáng thiết bị.Có thể thay đổi
device_set_volumeĐặt âm lượng thiết bị.Có thể thay đổi
device_trollstore_installYêu cầu cài IPA/TIPA qua TrollStore.Có thể thay đổi
device_ui_element_actionThực thi thao tác trên phần tử UI đã chọn.Có thể thay đổi
device_ui_element_queryĐọc phần tử UI theo điều kiện hoặc vị trí.Chỉ đọc
device_ui_element_snapshotĐọc phần tử UI, khung và khả năng nhấn.Chỉ đọc
device_unlockYêu cầu mở khóa màn hình thiết bị.Có thể thay đổi

Nhóm (groups)​

Công cụMô tảTác động
backend_group_add_devicesThêm thành viên nhóm.Có thể thay đổi
backend_group_createTạo nhóm thiết bị.Có thể thay đổi
backend_group_deleteXóa nhóm thiết bị.Có thể thay đổi
backend_group_delete_script_configXóa cấu hình nhóm của một script.Có thể thay đổi
backend_group_get_script_configĐọc cấu hình nhóm của một script.Chỉ đọc
backend_group_listLiệt kê nhóm thiết bị.Chỉ đọc
backend_group_list_script_configsLiệt kê cấu hình script đã lưu của nhóm.Chỉ đọc
backend_group_remove_devicesLoại bỏ thành viên nhóm.Có thể thay đổi
backend_group_renameĐổi tên nhóm thiết bị.Có thể thay đổi
backend_group_reorderSắp xếp lại nhóm thiết bị.Có thể thay đổi
backend_group_set_scriptĐặt script gắn với nhóm.Có thể thay đổi
backend_group_set_script_configThay thế toàn bộ cấu hình nhóm của một script.Có thể thay đổi

Script (scripts)​

Công cụMô tảTác động
backend_list_scriptsLiệt kê script có thể chạy trên trung tâm.Chỉ đọc
backend_read_scriptĐọc nội dung UTF-8 của script trung tâm.Chỉ đọc
backend_write_scriptGhi hoặc ghi đè nội dung UTF-8 của script trung tâm.Có thể thay đổi
device_get_selected_scriptĐọc script đang chọn trên thiết bị.Chỉ đọc
device_launch_scriptThực thi script trên thiết bị.Có thể thay đổi
device_pause_scriptTạm dừng script trên thiết bị.Có thể thay đổi
device_resume_scriptTiếp tục script trên thiết bị.Có thể thay đổi
device_run_script_snippetThực thi đoạn Lua ngắn trên thiết bị.Có thể thay đổi
device_select_scriptĐặt script đang chọn trên thiết bị.Có thể thay đổi
device_send_script_and_encryptThực thi mã hóa script hoặc dự án trên thiết bị và lưu về trung tâm.Có thể thay đổi
device_send_script_and_runThực thi truyền và khởi chạy script hoặc dự án.Có thể thay đổi
device_stop_scriptDừng script trên thiết bị.Có thể thay đổi
device_upload_scriptThực thi tải script trung tâm lên thiết bị.Có thể thay đổi

Tệp (files)​

Công cụMô tảTác động
backend_file_copySao chép tệp hoặc thư mục trung tâm.Có thể thay đổi
backend_file_deleteXóa tệp hoặc thư mục trung tâm.Có thể thay đổi
backend_file_existsKiểm tra tệp hoặc thư mục trung tâm.Chỉ đọc
backend_file_hashĐọc giá trị kiểm tra tệp trung tâm.Chỉ đọc
backend_file_listLiệt kê tệp hoặc thư mục trung tâm.Chỉ đọc
backend_file_mkdirTạo thư mục trung tâm.Có thể thay đổi
backend_file_moveDi chuyển tệp hoặc thư mục trung tâm.Có thể thay đổi
backend_file_readĐọc nội dung tệp trung tâm.Chỉ đọc
backend_file_renameĐổi tên tệp hoặc thư mục trung tâm.Có thể thay đổi
backend_file_writeGhi hoặc ghi đè nội dung tệp trung tâm.Có thể thay đổi
device_root_file_copySao chép tệp hoặc thư mục thiết bị theo đường dẫn tuyệt đối.Có thể thay đổi
device_root_file_listLiệt kê tệp hoặc thư mục thiết bị theo đường dẫn tuyệt đối.Chỉ đọc
device_root_file_mkdirTạo thư mục thiết bị theo đường dẫn tuyệt đối.Có thể thay đổi
device_root_file_moveDi chuyển tệp hoặc thư mục thiết bị theo đường dẫn tuyệt đối.Có thể thay đổi
device_root_file_removeXóa tệp hoặc thư mục thiết bị theo đường dẫn tuyệt đối.Có thể thay đổi
device_root_file_save_to_backendThực thi lưu tệp thiết bị theo đường dẫn tuyệt đối về trung tâm.Có thể thay đổi
device_root_file_statĐọc siêu dữ liệu tệp thiết bị theo đường dẫn tuyệt đối.Chỉ đọc
device_xxt_home_file_copySao chép tệp hoặc thư mục trong XXT Home.Có thể thay đổi
device_xxt_home_file_listLiệt kê tệp hoặc thư mục trong XXT Home.Chỉ đọc
device_xxt_home_file_mkdirTạo thư mục trong XXT Home.Có thể thay đổi
device_xxt_home_file_moveDi chuyển tệp hoặc thư mục trong XXT Home.Có thể thay đổi
device_xxt_home_file_readĐọc nội dung tệp trong XXT Home.Chỉ đọc
device_xxt_home_file_removeXóa tệp trong XXT Home.Có thể thay đổi
device_xxt_home_file_rmdirXóa thư mục trống trong XXT Home.Có thể thay đổi
device_xxt_home_file_writeGhi hoặc ghi đè nội dung tệp trong XXT Home.Có thể thay đổi
device_xxt_home_save_file_to_backendLưu tệp hoặc thư mục từ XXT Home vào một thư mục trên máy chủ.Có thể thay đổi
device_xxt_home_send_filesGửi tệp hoặc thư mục từ máy chủ đến XXT Home trên thiết bị.Có thể thay đổi

Hình ảnh (images)​

Công cụMô tảTác động
backend_binarize_imageThực thi nhị phân hóa và lưu ảnh.Có thể thay đổi
backend_crop_imageThực thi cắt và lưu vùng ảnh chữ nhật.Có thể thay đổi
backend_extract_matrixThực thi trích ma trận một ký tự và lưu ảnh.Có thể thay đổi
backend_fit_binary_selectionThực thi khớp sát vùng chọn nội dung nhị phân.Chỉ đọc
backend_matrix_line_from_binary_imageThực thi chuyển ảnh nhị phân thành dòng MatrixDict.Chỉ đọc
backend_pick_image_colorsĐọc màu tại các điểm ảnh chỉ định.Chỉ đọc
backend_split_matrixThực thi tách dải ký tự thành ma trận theo cột trống.Chỉ đọc
backend_view_imageĐọc bản xem trước ảnh trên trung tâm.Chỉ đọc
device_get_screen_sizeĐọc kích thước màn hình vật lý và chuyển đổi tọa độ.Chỉ đọc
device_get_screenshotĐọc ảnh chụp thiết bị và thông tin tọa độ.Chỉ đọc

Dữ liệu (data)​

Công cụMô tảTác động
backend_kvdb_dict_clearXóa hết cặp khóa-giá trị từ điển KVDB.Có thể thay đổi
backend_kvdb_dict_createTạo từ điển KVDB.Có thể thay đổi
backend_kvdb_dict_delete_allXóa từ điển KVDB.Có thể thay đổi
backend_kvdb_dict_delete_keyXóa một khóa từ điển KVDB.Có thể thay đổi
backend_kvdb_dict_delete_keysXóa các khóa từ điển KVDB đã chọn.Có thể thay đổi
backend_kvdb_dict_getĐọc một giá trị từ điển KVDB.Chỉ đọc
backend_kvdb_dict_get_allLiệt kê cặp khóa-giá trị từ điển KVDB.Chỉ đọc
backend_kvdb_dict_incrTăng nguyên tử chuỗi số nguyên trong từ điển.Có thể thay đổi
backend_kvdb_dict_putGhi hoặc ghi đè một giá trị từ điển KVDB.Có thể thay đổi
backend_kvdb_dict_renameĐổi tên từ điển KVDB.Có thể thay đổi
backend_kvdb_dict_replaceThay thế toàn bộ cặp khóa-giá trị từ điển KVDB.Có thể thay đổi
backend_kvdb_dict_upsertHợp nhất và ghi cặp khóa-giá trị từ điển KVDB.Có thể thay đổi
backend_kvdb_exportXuất bản sao lưu SQLite toàn bộ KVDB.Có thể thay đổi
backend_kvdb_importNhập bản sao lưu SQLite toàn bộ KVDB.Có thể thay đổi
backend_kvdb_list_dictsLiệt kê từ điển KVDB.Chỉ đọc
backend_kvdb_list_queuesLiệt kê hàng đợi KVDB.Chỉ đọc
backend_kvdb_queue_clearXóa hết phần tử hàng đợi KVDB.Có thể thay đổi
backend_kvdb_queue_countĐếm phần tử hàng đợi KVDB.Chỉ đọc
backend_kvdb_queue_createTạo hàng đợi KVDB.Có thể thay đổi
backend_kvdb_queue_delete_allXóa hàng đợi KVDB.Có thể thay đổi
backend_kvdb_queue_delete_indicesXóa phần tử hàng đợi tại vị trí chỉ định.Có thể thay đổi
backend_kvdb_queue_listLiệt kê phần tử hàng đợi KVDB.Chỉ đọc
backend_kvdb_queue_moveThực thi chuyển nguyên tử giữa các hàng đợi KVDB.Có thể thay đổi
backend_kvdb_queue_popLấy khỏi hàng đợi và trả về phần tử hàng đợi KVDB.Có thể thay đổi
backend_kvdb_queue_pushĐưa vào hàng đợi phần tử hàng đợi KVDB.Có thể thay đổi
backend_kvdb_queue_renameĐổi tên hàng đợi KVDB.Có thể thay đổi
backend_kvdb_queue_replaceThay thế toàn bộ phần tử hàng đợi KVDB.Có thể thay đổi
backend_tabledb_add_columnsThêm cột người dùng TableDB.Có thể thay đổi
backend_tabledb_add_rowsThêm hàng dữ liệu TableDB.Có thể thay đổi
backend_tabledb_count_rowsĐếm hàng TableDB khớp điều kiện.Chỉ đọc
backend_tabledb_createTạo bảng TableDB.Có thể thay đổi
backend_tabledb_delete_rowsXóa hàng dữ liệu TableDB.Có thể thay đổi
backend_tabledb_delete_tableXóa bảng TableDB.Có thể thay đổi
backend_tabledb_drop_columnsXóa cột người dùng TableDB.Có thể thay đổi
backend_tabledb_edit_rowsCập nhật hàng dữ liệu TableDB.Có thể thay đổi
backend_tabledb_exportXuất hàng dữ liệu TableDB.Có thể thay đổi
backend_tabledb_export_allXuất bản sao lưu SQLite toàn bộ TableDB.Có thể thay đổi
backend_tabledb_export_selectionXuất hàng và cột TableDB đã chọn.Có thể thay đổi
backend_tabledb_fetch_oneThực thi lấy nguyên tử một hàng và cập nhật tùy chọn.Có thể thay đổi
backend_tabledb_get_rowĐọc hàng TableDB theo ID.Chỉ đọc
backend_tabledb_get_schemaĐọc cấu trúc bảng TableDB.Chỉ đọc
backend_tabledb_importNhập hàng dữ liệu TableDB.Có thể thay đổi
backend_tabledb_import_allNhập bản sao lưu SQLite toàn bộ TableDB.Có thể thay đổi
backend_tabledb_list_rowsLiệt kê hàng dữ liệu TableDB.Chỉ đọc
backend_tabledb_list_tablesLiệt kê bảng TableDB.Chỉ đọc
backend_tabledb_rename_columnĐổi tên cột người dùng TableDB.Có thể thay đổi
backend_tabledb_rename_tableĐổi tên bảng TableDB.Có thể thay đổi
backend_tabledb_reorder_columnsĐặt thứ tự cột TableDB.Có thể thay đổi
backend_tabledb_truncateXóa hết hàng dữ liệu TableDB.Có thể thay đổi

Lịch (schedules)​

Công cụMô tảTác động
backend_schedule_cancel_runHủy một lần chạy lịch.Có thể thay đổi
backend_schedule_createTạo định nghĩa lịch.Có thể thay đổi
backend_schedule_deleteXóa lịch tác vụ.Có thể thay đổi
backend_schedule_exportXuất bản sao lưu JSON của lịch.Chỉ đọc
backend_schedule_getĐọc định nghĩa lịch.Chỉ đọc
backend_schedule_importNhập bản sao lưu JSON của lịch.Có thể thay đổi
backend_schedule_listLiệt kê lịch tác vụ.Chỉ đọc
backend_schedule_list_runsLiệt kê lịch sử và trạng thái chạy lịch.Chỉ đọc
backend_schedule_runGửi một lần chạy lịch.Có thể thay đổi
backend_schedule_set_enabledĐặt trạng thái kích hoạt tự động của lịch.Có thể thay đổi
backend_schedule_updateThay thế toàn bộ định nghĩa lịch.Có thể thay đổi
backend_schedule_validateKiểm tra tĩnh và chuẩn hóa định nghĩa lịch.Chỉ đọc

Tác vụ nền (tasks)​

Công cụMô tảTác động
backend_batch_authorize_continueTiếp tục tác vụ cấp quyền hàng loạt.Có thể thay đổi
backend_batch_authorize_pauseTạm dừng tác vụ cấp quyền hàng loạt.Có thể thay đổi
backend_batch_authorize_startGửi tác vụ cấp quyền hàng loạt.Có thể thay đổi
backend_batch_executeGửi tác vụ thao tác thiết bị hàng loạt.Có thể thay đổi
backend_task_cancelYêu cầu hủy tác vụ nền.Có thể thay đổi
backend_task_getĐọc trạng thái và tổng hợp tác vụ nền.Chỉ đọc
backend_task_listLiệt kê tác vụ nền theo nguồn.Chỉ đọc
backend_task_resultsĐọc kết quả từng mục của tác vụ nền.Chỉ đọc
backend_task_retryThử lại mục thất bại của tác vụ Agent đã kết thúc.Có thể thay đổi

Phiên IDE (ide)​

Công cụMô tảTác động
ide_bind_sessionĐặt liên kết IDE của kết nối MCP hiện tại.Có thể thay đổi
ide_get_bound_sessionĐọc liên kết IDE của kết nối MCP hiện tại.Chỉ đọc
ide_get_contextĐọc ngữ cảnh workspace, tệp và lựa chọn IDE.Chỉ đọc
ide_list_sessionsLiệt kê phiên IDE đang hoạt động.Chỉ đọc
ide_resolve_selected_deviceĐọc thiết bị đang chọn trong IDE.Chỉ đọc

Hỗ trợ thủ công (assist)​

Công cụMô tảTác động
xxt_assist_cancel_taskHủy tác vụ hỗ trợ thủ công.Có thể thay đổi
xxt_assist_create_taskTạo tác vụ hỗ trợ thủ công.Có thể thay đổi
xxt_assist_get_taskĐọc trạng thái và kết quả tác vụ hỗ trợ.Chỉ đọc
xxt_assist_list_tasksLiệt kê tác vụ hỗ trợ thủ công.Chỉ đọc
xxt_assist_wait_resultYêu cầu chờ kết quả hỗ trợ thủ công.Chỉ đọc

Hệ thống (system)​

Công cụMô tảTác động
backend_get_app_configĐọc cài đặt ứng dụng có kiểu công khai.Chỉ đọc
backend_get_configĐọc một mục cấu hình chuỗi.Chỉ đọc
backend_healthKiểm tra khả năng truy cập dịch vụ trung tâm.Chỉ đọc
backend_rename_devicesCập nhật tên thiết bị và đồng bộ bản ghi trung tâm.Có thể thay đổi
backend_set_app_configCập nhật cài đặt ứng dụng có kiểu công khai.Có thể thay đổi
backend_set_configĐặt một mục cấu hình chuỗi.Có thể thay đổi
backend_versionĐọc phiên bản backend.Chỉ đọc