Tham chiếu công cụ MCP
MCP cung cấp năm công cụ: tool_list, tool_info, tool_call, skill_list, skill_read, lần lượt cho tên công cụ nghiệp vụ, định nghĩa, gọi nghiệp vụ, danh mục Skill và đọc tài liệu Skill. Danh mục chỉ dùng để điều hướng khi cần. Truy vấn nghiệp vụ, thay đổi và điều khiển thiết bị đều qua tool_call, bắt buộc có tool. Gọi trực tiếp thao tác đã biết; tài liệu Skill và tham chiếu chỉ đọc khi cần. args là đối tượng tham số nghiệp vụ tùy chọn.
| Công cụ | Mô tả | Tác động |
|---|---|---|
tool_list | Trả tên công cụ nghiệp vụ, có thể lọc theo danh mục. | Chỉ đọc |
tool_info | Trả mô tả, lược đồ tham số và tác động của công cụ đã chọn, không thực thi nghiệp vụ. | Chỉ đọc |
tool_call | Gọi công cụ nghiệp vụ để truy vấn, thay đổi hoặc thao tác thiết bị. | Tùy công cụ nghiệp vụ |
skill_list | Trả tên, mô tả Skill tích hợp cùng gợi ý đọc và tải xuống. | Chỉ đọc |
skill_read | Đọc tệp chính hoặc tài liệu tham chiếu Skill, hỗ trợ phân trang. | Chỉ đọc |
Ví dụ gọi
tool_list({}): Trả vềversionvà danh sách têntoolsđã sắp xếp.tool_list({category:"devices"}): Lọc tên thao tác theocategory.tool_info({tools:"backend_list_devices"}): Mô tả cách dùng một công cụ mà không thực thi công cụ đó.tool_info({tools:["backend_list_devices","device_get_status"]}): Mô tả nhiều công cụ cần thiết mà không thực thi. Trả về mảngtools, mỗi mục chứa ID nội bộtool,description,inputSchema(chotool_call.args) vàreadOnly.toolsnhận một chuỗi không rỗng hoặc một mảng chuỗi không rỗng, không giới hạn số mục cố định cho mỗi lô.tool_call({tool:"backend_list_devices",args:{limit:10}}): Gọi trực tiếp công cụ đã biết để đọc danh sách thiết bị cần thiết.skill_list({}): Liệt kê tên Skill, mô tả và gợi ýreadCall.skill_read({skill:"xxtlancontrol"}): Đọc trực tiếp Skill chính khi đã biết tên;pathmặc định làSKILL.md.skill_read({skill:"xxtlancontrol",path:"references/tasks.md"}): Đọc quy trình theo liên kết tương đối từ Skill chính;cursor/maxByteshỗ trợ phân trang.
Các gợi ý gọi của ứng dụng readCall, infoCall và listCall dùng {name,args}; name chỉ định công cụ MCP công khai. Mã Skill nằm ở skills[].skill trong danh mục và data.skill trong kết quả đọc.
Mỗi mục skill_list cung cấp downloadUrl, URL đầy đủ trên trung tâm hiện tại để tải toàn bộ Skill ZIP. skill_read trả về văn bản của tệp được chọn và kèm liên kết tải toàn bộ gói Skill. ZIP gồm hướng dẫn chính, tài liệu tham chiếu và các tập lệnh, mẫu, tài nguyên đi kèm. Nếu chỉ cần tải xuống, siêu dữ liệu danh mục là đủ; dùng trực tiếp liên kết đã có, không cần đọc văn bản hay liệt kê lại.
Khi chưa rõ tên, xem tool_list theo nhóm. Khi chưa rõ tham số, dùng tool_info để đọc các định nghĩa cần thiết cùng lúc, rồi thực hiện qua tool_call. Công cụ đã biết có thể gọi trực tiếp, không cần xem danh mục hay định nghĩa trước.
Sau khi thao tác hàng loạt trả về ID tác vụ, truy vấn trạng thái và các mục thất bại. Kết nối lại MCP sau khi cập nhật trung tâm điều khiển.
Chạy lệnh shell trên thiết bị
Trong cài đặt MCP, bật Cho phép thực thi lệnh shell trên thiết bị rồi lưu để chạy lệnh shell trên thiết bị. Mặc định tùy chọn này tắt. Khi tắt và lưu, công cụ sẽ ẩn trong mọi phiên MCP và các lệnh gọi mới sẽ bị từ chối.
command là dòng lệnh đầy đủ, tối đa 16384 ký tự, được shell của thiết bị thực thi với -c. Kết quả gồm mã thoát, stdout, stderr và lưu ý về đường dẫn khi dùng shell roothide.
Thời gian chờ mặc định là 10 giây. Với lệnh dài, đặt timeoutMs (ví dụ 300000 cho 5 phút) và cho phép đủ thời gian trên máy khách MCP. Bộ điều khiển gia hạn aux khi bắt đầu và trao đổi tín hiệu duy trì kết nối với thiết bị mỗi 30 giây. Sau khi tác vụ cuối kết thúc, aux thoát sau 180 giây không hoạt động.
{"tool":"device_run_shell_command","args":{"udid":"DEVICE_UDID","command":"df -h"}}