RemoteAC exposes 7 tools with Korean descriptions and minimal parameter documentation. All tools are registered via [McpServerTool] attributes with names and descriptions present. However, critical gaps undermine usability: (1) Input schemas are either empty {} or minimally documented, tools like room_get_status and ac_get_status accept no parameters but lack output schema documentation; (2) Parameter descriptions exist but are sparse and lack type constraints (e.g., ac_set_op_mode accepts 'operationMode' string with no enum constraint in schema, only in description); (3) No error handling guidance, SetTemperature clamps silently, SetOperationMode returns error text but no structured recovery path; (4) Output schemas are inferred from return types (RoomStatus, AirconStatus, ControlResult) but not explicitly documented in tool definitions. Tool names follow verb_noun pattern (get_, set_, turn_) which is good, but descriptions are in Korean, limiting LLM comprehension in English-first environments.
에어컨 상태를 가져옵니다.
에어컨의 바람 세기를 설정합니다. 에어컨이 켜져 있으면서 운전 모드가 'Auto'(자동)이나 'Dry'(제습)이 아닐 때 설정 가능합니다. 바람 세기는 'Low'(가장 약함), 'Mid'(중간 정도), 'High'(가장 강함)과 자동으로 바람 세기를 조절하는 'Auto'가 있습니다.
에어컨의 운전 모드를 설정합니다. 에어컨이 켜져 있을 때 설정 가능하며, 운전 모드로는 'Auto'(자동), 'Cool'(냉방), 'Dry'(제습), 'Heat'(난방), 'Fan'(송풍) 모드가 있습니다.
에어컨의 온도를 섭씨(℃) 기준 정수형으로 설정합니다. 에어컨이 켜져 있으면서 운전 모드가 'Fan'(송풍)이 아닐 때, 17 ~ 30℃ 범위로 설정 가능합니다.
에어컨을 끕니다.
에어컨을 켭니다.
작업실 환경 정보를 가져옵니다.
No output schemas documented. Tools return RoomStatus, AirconStatus, ControlResult but LLMs cannot see field names, types, or structure. Agents cannot plan downstream calls or extract specific fields.
Parameter enums not declared in schemas. ac_set_op_mode and ac_set_fan_speed accept constrained string values (Auto/Cool/Dry/Heat/Fan, Low/Mid/High/Auto) but schemas show bare 'string' type with no enum constraint. LLMs may hallucinate invalid values.
Descriptions in Korean limit LLM comprehension in English-first environments. Tool and parameter descriptions should be in English for maximum compatibility with multilingual LLM agents.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 49 | 2026-07-28+ | v2 |
No error recovery guidance. SetOperationMode returns error text ('잘못된 운전 모드입니다...') but does not guide the LLM on next steps. SetTemperature silently clamps out-of-range values without clear feedback.
Parameter descriptions lack format/range constraints. ac_set_temperature description mentions '17 ~ 30℃ 범위' but schema has no minValue/maxValue. LLMs cannot validate input before calling.