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

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_listTrả tên công cụ nghiệp vụ, có thể lọc theo danh mục.Chỉ đọc
tool_infoTrả 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_callGọ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_listTrả 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ề version và danh sách tên tools đã sắp xếp.
  • tool_list({category:"devices"}): Lọc tên thao tác theo category.
  • 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ảng tools, mỗi mục chứa ID nội bộ tool, description, inputSchema (cho tool_call.args) và readOnly. tools nhậ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; path mặ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 / maxBytes hỗ 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"}}