MCP 도구 참조
MCP는 업무 도구 이름, 사용법 정의, 업무 호출, Skill 목록, Skill 문서 읽기를 담당하는 tool_list, tool_info, tool_call, skill_list, skill_read 다섯 도구를 제공합니다. 목록은 필요할 때 탐색용으로 조회합니다. 업무 조회, 변경, 기기 작업은 모두 tool_call을 사용하며 tool은 필수입니다. 아는 작업은 바로 호출하고 Skill과 참조 문서는 필요할 때 읽으세요. args는 업무 매개변수를 담는 선택적 객체입니다.
| 도구 | 설명 | 효과 |
|---|---|---|
tool_list | 업무 도구 이름을 반환하며 분류로 필터링할 수 있습니다. | 읽기 전용 |
tool_info | 지정한 도구의 설명, 매개변수 스키마와 효과를 반환하며 업무 작업은 실행하지 않습니다. | 읽기 전용 |
tool_call | 업무 도구를 호출하여 조회, 변경 또는 장치 동작을 실행합니다. | 업무 도구에 따라 결정 |
skill_list | 내장 Skill 이름, 설명 및 읽기와 다운로드 안내를 반환합니다. | 읽기 전용 |
skill_read | Skill 기본 파일 또는 참조 파일을 페이지 단위로 읽습니다. | 읽기 전용 |
호출 예제
tool_list({}):version과 정렬된tools이름 목록을 반환합니다.tool_list({category:"devices"}):category로 범주별 작업 이름을 조회합니다.tool_info({tools:"backend_list_devices"}): 도구 하나의 사용법만 설명하며 실행하지 않습니다.tool_info({tools:["backend_list_devices","device_get_status"]}): 필요한 여러 도구의 사용법만 설명하고 실행하지 않습니다. 결과는tools배열이며 각 항목은 내부 IDtool,description,inputSchema(tool_call.args용),readOnly를 포함합니다.tools는 비어 있지 않은 문자열 또는 비어 있지 않은 문자열 배열이며 일괄 조회 항목 수에 고정된 제한은 없습니다.tool_call({tool:"backend_list_devices",args:{limit:10}}): 아는 도구를 직접 호출해 필요한 기기 목록을 읽습니다.skill_list({}): Skill 이름, 설명 및readCall안내를 나열합니다.skill_read({skill:"xxtlancontrol"}): 이름을 알면 주 Skill을 바로 읽습니다.path의 기본값은SKILL.md입니다.skill_read({skill:"xxtlancontrol",path:"references/tasks.md"}): 주 Skill의 상대 링크로 절차를 읽습니다.cursor/maxBytes로 페이지를 나눠 읽을 수 있습니다.
앱 호출 안내 readCall, infoCall, listCall은 {name,args}를 사용하며 name은 공개 MCP 도구를 지정합니다. Skill ID는 목록의 skills[].skill과 읽기 결과의 data.skill에 반환됩니다.
skill_list의 각 항목은 현재 중앙 제어 서버에서 전체 Skill ZIP을 받는 완전한 URL downloadUrl을 제공합니다. skill_read은 선택한 단일 파일의 텍스트와 전체 Skill 패키지 다운로드 링크를 함께 반환합니다. ZIP에는 주 문서, 참조 문서, 제공되는 스크립트, 템플릿 및 자료가 포함됩니다. 다운로드만 필요하면 목록 메타데이터로 충분하며, 이미 받은 링크는 본문을 읽거나 목록을 다시 조회하지 않고 바로 사용할 수 있습니다.
이름을 모를 때는 범주별 tool_list를 확인하세요. 매개변수가 불명확하면 tool_info로 필요한 정의를 함께 읽고 tool_call로 실행하세요. 아는 도구는 목록이나 정의를 먼저 읽지 않고 바로 호출할 수 있습니다.
일괄 작업에서 작업 ID가 반환되면 상태와 실패 항목을 조회합니다. 중앙 제어를 업데이트한 뒤에는 MCP를 다시 연결하세요.
기기에서 셸 명령 실행
MCP 설정에서 기기에서 셸 명령 실행 허용을 켜고 저장하면 기기에서 셸 명령을 실행할 수 있습니다. 기본값은 꺼짐입니다. 끄고 저장하면 모든 MCP 세션에서 도구가 숨겨지고 새 호출이 거부됩니다.
command는 최대 16384자의 완전한 명령줄이며 기기 셸이 -c로 실행합니다. 결과에는 종료 코드, 표준 출력, 표준 오류 및 roothide 셸의 경로 안내가 포함됩니다.
기본 명령 제한 시간은 10초입니다. 오래 걸리는 명령은 timeoutMs를 설정하고(예: 5분은 300000), MCP 클라이언트의 제한 시간도 충분히 늘리세요. 컨트롤러는 시작 시 aux 유지 시간을 갱신하며 실행 중에는 30초마다 기기와 하트비트를 교환합니다. 마지막 작업이 끝나고 180초 동안 유휴 상태가 지속되면 aux가 종료됩니다.
{"tool":"device_run_shell_command","args":{"udid":"DEVICE_UDID","command":"df -h"}}