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_devices | Gửi bản tin dò thiết bị UDP. | Có thể thay đổi |
backend_import_device | Nhập thiết bị theo địa chỉ. | Có thể thay đổi |
backend_import_devices | Gửi tác vụ nhập thiết bị hàng loạt. | Có thể thay đổi |
backend_list_devices | Liệt kê thiết bị đã đăng ký. | Chỉ đọc |
backend_scan_ips | Kiểm tra phản hồi TCP tại địa chỉ và cổng IPv4. | Có thể thay đổi |
backend_scan_networks | Liệ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_data | Xóa hết dữ liệu ứng dụng đã chọn. | Có thể thay đổi |
device_clear_logs | Xó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_record | Xóa bản ghi thiết bị trên trung tâm. | Có thể thay đổi |
device_export_logs | Xuấ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_applist | Liệ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_sequence | Thực thi chuỗi chạm, phím và chờ theo thứ tự. | Có thể thay đổi |
device_install_package | Cập nhật XXTouch trên thiết bị. | Có thể thay đổi |
device_list_apps | Liệt kê ứng dụng đã cài và mã định danh. | Chỉ đọc |
device_lock | Yê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_reboot | Yêu cầu khởi động lại thiết bị. | Có thể thay đổi |
device_respring | Yê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_install | Yêu cầu cài IPA/TIPA qua TrollStore. | Có thể thay đổi |
device_ui_element_action | Thự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_unlock | Yê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_devices | Thêm thành viên nhóm. | Có thể thay đổi |
backend_group_create | Tạo nhóm thiết bị. | Có thể thay đổi |
backend_group_delete | Xóa nhóm thiết bị. | Có thể thay đổi |
backend_group_delete_script_config | Xó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_list | Liệt kê nhóm thiết bị. | Chỉ đọc |
backend_group_list_script_configs | Liệt kê cấu hình script đã lưu của nhóm. | Chỉ đọc |
backend_group_remove_devices | Loạ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_reorder | Sắ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_config | Thay 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_scripts | Liệ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_script | Ghi 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_script | Thực thi script trên thiết bị. | Có thể thay đổi |
device_pause_script | Tạm dừng script trên thiết bị. | Có thể thay đổi |
device_resume_script | Tiếp tục script trên thiết bị. | Có thể thay đổi |
device_run_script_snippet | Thự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_encrypt | Thự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_run | Thực thi truyền và khởi chạy script hoặc dự án. | Có thể thay đổi |
device_stop_script | Dừng script trên thiết bị. | Có thể thay đổi |
device_upload_script | Thự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_copy | Sao chép tệp hoặc thư mục trung tâm. | Có thể thay đổi |
backend_file_delete | Xóa tệp hoặc thư mục trung tâm. | Có thể thay đổi |
backend_file_exists | Kiể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_list | Liệt kê tệp hoặc thư mục trung tâm. | Chỉ đọc |
backend_file_mkdir | Tạo thư mục trung tâm. | Có thể thay đổi |
backend_file_move | Di 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_write | Ghi hoặc ghi đè nội dung tệp trung tâm. | Có thể thay đổi |
device_root_file_copy | Sao 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_list | Liệt kê tệp hoặc thư mục thiết bị theo đường dẫn tuyệt đối. | Chỉ đọc |
device_root_file_mkdir | Tạo thư mục thiết bị theo đường dẫn tuyệt đối. | Có thể thay đổi |
device_root_file_move | Di 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_remove | Xó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_backend | Thự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_copy | Sao chép tệp hoặc thư mục trong XXT Home. | Có thể thay đổi |
device_xxt_home_file_list | Liệt kê tệp hoặc thư mục trong XXT Home. | Chỉ đọc |
device_xxt_home_file_mkdir | Tạo thư mục trong XXT Home. | Có thể thay đổi |
device_xxt_home_file_move | Di 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_remove | Xóa tệp trong XXT Home. | Có thể thay đổi |
device_xxt_home_file_rmdir | Xóa thư mục trống trong XXT Home. | Có thể thay đổi |
device_xxt_home_file_write | Ghi hoặc ghi đè nội dung tệp trong XXT Home. | Có thể thay đổi |
device_xxt_home_save_file_to_backend | Lư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_files | Gử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_image | Thực thi nhị phân hóa và lưu ảnh. | Có thể thay đổi |
backend_crop_image | Thực thi cắt và lưu vùng ảnh chữ nhật. | Có thể thay đổi |
backend_extract_matrix | Thực thi trích ma trận một ký tự và lưu ảnh. | Có thể thay đổi |
backend_fit_binary_selection | Thực thi khớp sát vùng chọn nội dung nhị phân. | Chỉ đọc |
backend_matrix_line_from_binary_image | Thự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_matrix | Thự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_clear | Xóa hết cặp khóa-giá trị từ điển KVDB. | Có thể thay đổi |
backend_kvdb_dict_create | Tạo từ điển KVDB. | Có thể thay đổi |
backend_kvdb_dict_delete_all | Xóa từ điển KVDB. | Có thể thay đổi |
backend_kvdb_dict_delete_key | Xóa một khóa từ điển KVDB. | Có thể thay đổi |
backend_kvdb_dict_delete_keys | Xó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_all | Liệt kê cặp khóa-giá trị từ điển KVDB. | Chỉ đọc |
backend_kvdb_dict_incr | Tăng nguyên tử chuỗi số nguyên trong từ điển. | Có thể thay đổi |
backend_kvdb_dict_put | Ghi 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_replace | Thay thế toàn bộ cặp khóa-giá trị từ điển KVDB. | Có thể thay đổi |
backend_kvdb_dict_upsert | Hợp nhất và ghi cặp khóa-giá trị từ điển KVDB. | Có thể thay đổi |
backend_kvdb_export | Xuất bản sao lưu SQLite toàn bộ KVDB. | Có thể thay đổi |
backend_kvdb_import | Nhập bản sao lưu SQLite toàn bộ KVDB. | Có thể thay đổi |
backend_kvdb_list_dicts | Liệt kê từ điển KVDB. | Chỉ đọc |
backend_kvdb_list_queues | Liệt kê hàng đợi KVDB. | Chỉ đọc |
backend_kvdb_queue_clear | Xó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_create | Tạo hàng đợi KVDB. | Có thể thay đổi |
backend_kvdb_queue_delete_all | Xóa hàng đợi KVDB. | Có thể thay đổi |
backend_kvdb_queue_delete_indices | Xóa phần tử hàng đợi tại vị trí chỉ định. | Có thể thay đổi |
backend_kvdb_queue_list | Liệt kê phần tử hàng đợi KVDB. | Chỉ đọc |
backend_kvdb_queue_move | Thực thi chuyển nguyên tử giữa các hàng đợi KVDB. | Có thể thay đổi |
backend_kvdb_queue_pop | Lấ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_replace | Thay thế toàn bộ phần tử hàng đợi KVDB. | Có thể thay đổi |
backend_tabledb_add_columns | Thêm cột người dùng TableDB. | Có thể thay đổi |
backend_tabledb_add_rows | Thê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_create | Tạo bảng TableDB. | Có thể thay đổi |
backend_tabledb_delete_rows | Xóa hàng dữ liệu TableDB. | Có thể thay đổi |
backend_tabledb_delete_table | Xóa bảng TableDB. | Có thể thay đổi |
backend_tabledb_drop_columns | Xóa cột người dùng TableDB. | Có thể thay đổi |
backend_tabledb_edit_rows | Cập nhật hàng dữ liệu TableDB. | Có thể thay đổi |
backend_tabledb_export | Xuất hàng dữ liệu TableDB. | Có thể thay đổi |
backend_tabledb_export_all | Xuất bản sao lưu SQLite toàn bộ TableDB. | Có thể thay đổi |
backend_tabledb_export_selection | Xuất hàng và cột TableDB đã chọn. | Có thể thay đổi |
backend_tabledb_fetch_one | Thự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_import | Nhập hàng dữ liệu TableDB. | Có thể thay đổi |
backend_tabledb_import_all | Nhập bản sao lưu SQLite toàn bộ TableDB. | Có thể thay đổi |
backend_tabledb_list_rows | Liệt kê hàng dữ liệu TableDB. | Chỉ đọc |
backend_tabledb_list_tables | Liệ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_truncate | Xó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_run | Hủy một lần chạy lịch. | Có thể thay đổi |
backend_schedule_create | Tạo định nghĩa lịch. | Có thể thay đổi |
backend_schedule_delete | Xóa lịch tác vụ. | Có thể thay đổi |
backend_schedule_export | Xuấ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_import | Nhập bản sao lưu JSON của lịch. | Có thể thay đổi |
backend_schedule_list | Liệt kê lịch tác vụ. | Chỉ đọc |
backend_schedule_list_runs | Liệt kê lịch sử và trạng thái chạy lịch. | Chỉ đọc |
backend_schedule_run | Gử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_update | Thay thế toàn bộ định nghĩa lịch. | Có thể thay đổi |
backend_schedule_validate | Kiể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_continue | Tiếp tục tác vụ cấp quyền hàng loạt. | Có thể thay đổi |
backend_batch_authorize_pause | Tạm dừng tác vụ cấp quyền hàng loạt. | Có thể thay đổi |
backend_batch_authorize_start | Gửi tác vụ cấp quyền hàng loạt. | Có thể thay đổi |
backend_batch_execute | Gửi tác vụ thao tác thiết bị hàng loạt. | Có thể thay đổi |
backend_task_cancel | Yê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_list | Liệ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_retry | Thử 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_sessions | Liệ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_task | Hủy tác vụ hỗ trợ thủ công. | Có thể thay đổi |
xxt_assist_create_task | Tạ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_tasks | Liệt kê tác vụ hỗ trợ thủ công. | Chỉ đọc |
xxt_assist_wait_result | Yê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_health | Kiểm tra khả năng truy cập dịch vụ trung tâm. | Chỉ đọc |
backend_rename_devices | Cập nhật tên thiết bị và đồng bộ bản ghi trung tâm. | Có thể thay đổi |
backend_set_app_config | Cậ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 |