Tapo

使用 npx mcporter call tapo. 控制 Tapo 设备。

配置

您需要在本地网络中运行一个 Tapo MCP 服务器（版本 v0.5.0 或更高版本，使用 HTTP 传输）。推荐使用 Bearer Token 认证方式（当服务器绑定到非回环地址时，此方式为必需）。若通过局域网 IP 或主机名连接，服务器的 TAPO_MCP_ALLOWED_HOSTS 环境变量必须包含该主机，否则请求将返回 403 Forbidden 错误。

1. 添加 Tapo 服务器：

   npx mcporter config add tapo http:// 
     --transport http 
     --header "Authorization=Bearer " 
     --scope home
   

2. 验证配置：

   npx mcporter list tapo --schema
   

   您应能看到以下工具： list_devices、check_device、get_device_state、control_device 和 take_snapshot。

完整配置流程、配置管理及故障排查，请参阅 references/setup.md。

工具

list_devices

列出网络中所有 Tapo 设备。

npx mcporter call tapo.list_devices

返回每个设备的 id、name、model、ip、set_capabilities、get_capabilities，以及 children（适用于智能插座和 H100 集线器）。

check_device

校验指定 IP 地址上设备 ID 是否匹配。

npx mcporter call tapo.check_device id="" ip=""

get_device_state

获取设备当前状态。该操作会自动先执行 check_device。

# 设备基本信息
npx mcporter call tapo.get_device_state id="" ip="" capability='{"type": "DeviceInfo"}'

# 触发日志（仅 S200、T100、T110、T300 集线器子设备）——按时间倒序排列（最新在前）
npx mcporter call tapo.get_device_state id="" ip="" capability='{"type": "TriggerLogs", "page_size": 20, "start_id": 0}'

# 过去 24 小时温湿度记录（仅 T310、T315 集线器子设备）
npx mcporter call tapo.get_device_state id="" ip="" capability='{"type": "TemperatureHumidityRecords"}'

control_device

控制设备。该操作会自动先执行 check_device。

# 开启设备
npx mcporter call tapo.control_device id="" ip="" capabilities='[{"type": "OnOff", "value": true}]'

# 关闭设备
npx mcporter call tapo.control_device id="" ip="" capabilities='[{"type": "OnOff", "value": false}]'

# 设置亮度（取值范围：1–100，仅限照明类设备）
npx mcporter call tapo.control_device id="" ip="" capabilities='[{"type": "Brightness", "value": 50}]'

# 设置颜色（仅限支持彩色的照明设备）
npx mcporter call tapo.control_device id="" ip="" capabilities='[{"type": "Color", "value": "Coral"}]'

# 同时设置多个能力项
npx mcporter call tapo.control_device id="" ip="" capabilities='[{"type": "Color", "value": "Coral"}, {"type": "Brightness", "value": 50}]'

take_snapshot

从 Tapo 摄像头捕获一张静态 JPEG 快照（分辨率约为 640×360）。该操作会自动先执行 check_device。服务器需预先配置 TAPO_MCP_CAMERA_USERNAME 和 TAPO_MCP_CAMERA_PASSWORD（在 Tapo App 中路径为：摄像头设置 > 高级设置 > 摄像头账户）。

npx mcporter call tapo.take_snapshot id="" ip=""

使用规范

1. 若无近期设备列表，请始终优先运行 list_devices；结果可缓存最多 30 分钟。
2. 请始终使用 list_devices 输出中的设备 id 和 ip —— 切勿猜测或硬编码这些值。
3. 对于智能插座（如 P304M）和 H100 集线器，其子设备拥有独立的 id；此时应使用子设备的 id，配合父设备（即集线器）的 ip 进行调用。