用途:当 SmallTV 本地 MCP 服务器已连接时,使用这些工具控制 SmallTV、读取状态、上传图片和 GIF、修改设置,以及刷写固件;相比直接使用 curl 或 Python requests 等原始 HTTP 方式更安全、参数编码和 multipart 上传由工具内部处理。
主要能力:smalltv-get-device-info 只读,用于通过 /v.json 验证连通性与型号;smalltv-read 只读,用于查询状态、配置和文件列表,支持的路径包括 /v.json、/space.json、/city.json、/album.json、/filelist?dir=...、/wifi.json?q=1、/config.json,/set、/wifisave、/delete 等写端点被该工具阻断;smalltv-write 用于更改设置或控制显示,常见形式如 path: "/set?param=value",成功返回 "OK";smalltv-upload-file 用于上传本地 JPG/GIF,需传 file_path 和 dir,如 "/image/" 或 "/gif",不可通过 smalltv-write 上传二进制;smalltv-upload-firmware 仅在用户明确要求刷写固件时使用,且需 confirm: true。
使用方式:建议每次会话先调用 smalltv-get-device-info 确认设备可达且为 SmallTV-Ultra。检查存储用 smalltv-read path="/space.json",查看已上传图片用 smalltv-read path="/filelist?dir=/image/"。设置亮度用 smalltv-write path="/set?brt=60"。上传并显示自定义图片时,先检查空间,再 smalltv-upload-file file_path="/tmp/dashboard.jpg" dir="/image/",之后 smalltv-write path="/set?img=/image/dashboard.jpg",并用 smalltv-write path="/set?theme=3" 切换到相册主题。天气 GIF 必须为 80x80px,上传到 "/gif" 后用 path="/set?gif=/gif/icon.gif" 显示。所有工具接受可选 device_ip 参数。
适用场景:需要以编程方式在原生固件上显示自定义内容,常见做法是在本地将内容渲染为 240x240 图片或动画 GIF,上传后显示。
限制与安全:/wifisave(空)、/set?reset=1、/set?reboot=1、/set?clear=image、/set?clear=gif、/delete?file={path} 等属于破坏性端点,未经用户明确请求不得调用。刷写固件可能损坏设备,需先验证型号、记录当前固件版本、确认用户有可回滚的 .bin 并取得明确批准。原生固件不支持文本显示端点,也不支持视频、音频、触屏及 WebSocket/MQTT 推送。