tuvio-vacuum
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Tuvio Vacuum MCP + Skill
MCP-сервер и Codex skill для управления роботом-пылесосом Tuvio/Tuya через локальный хаб.
Проект не содержит ключей, токенов, QR-кодов и приватного состояния. MCP-сервер обращается к уже настроенному локальному хабу, а хаб хранит Tuya device_id и local_key у вас на компьютере.
Что внутри
mcp_server/vacuum_mcp_server.py- MCP-серверtuvio-vacuum;hub/minimal_hub.py- минимальный локальный HTTP-хаб для одного пылесоса;skills/tuvio-vacuum-control/SKILL.md- skill для Codex;examples/codex-config.example.toml- пример секции для~/.codex/config.toml;docs/authorization.md- как получить авторизацию пылесоса до установки MCP;docs/minimal-hub.md- как запустить встроенный минимальный хаб;docs/install.md- установка MCP и skill;docs/capabilities.md- список возможностей.
Related MCP server: irobot-mcp
Быстрый старт
Получите
device_idиlocal_keyпылесоса. Подробно: docs/authorization.md.Установите зависимости:
pip install -r requirements.txtЗапустите встроенный минимальный хаб или свой совместимый хаб. Подробно: docs/minimal-hub.md.
Убедитесь, что хаб отвечает:
Invoke-WebRequest -UseBasicParsing http://127.0.0.1:8790/api/devicesДобавьте MCP-сервер в
C:\Users\<USER>\.codex\config.tomlпо примеру из examples/codex-config.example.toml.Скопируйте
skills/tuvio-vacuum-controlвC:\Users\<USER>\.codex\skills.Перезапустите Codex.
Что нужно новому владельцу Tuvio TR07MGBW
Этот репозиторий содержит MCP-сервер, Codex skill и минимальный локальный HTTP-хаб для одного пылесоса. Если у вас уже есть свой хаб, можно использовать его вместо встроенного.
Для рабочего запуска нужны:
пылесос, добавленный в Smart Life / Tuya Smart / Tuya Home или совместимое OEM-приложение;
device_idи актуальныйlocal_key;встроенный хаб из docs/minimal-hub.md или свой локальный хаб с API из docs/hub-api.md;
Python 3.10+ и доступ Codex к MCP-серверу.
Если после удаления или повторной привязки пылесоса команды перестали работать с ошибкой вида Check device key or version, получите новый local_key и обновите конфиг хаба. После перепривязки Tuya часто меняет локальный ключ.
Команды MCP
vacuum_statusvacuum_startvacuum_pausevacuum_homevacuum_findvacuum_set_modevacuum_set_suctionvacuum_set_watervacuum_drivevacuum_set_voicevacuum_set_powervacuum_reset_consumablevacuum_command
Безопасность
Не коммитьте:
Tuya
local_key;Tuya Client Secret;
пароль роутера;
hub_state.json;QR-коды авторизации;
cookies и временные ответы Tuya Cloud.
Для локальных секретов используйте приватный конфиг хаба, .env или менеджер секретов.
Ограничения
Этот MCP-сервер не реализует сам Tuya Cloud и не извлекает local_key. Встроенный минимальный хаб тоже не получает ключ автоматически: он использует значения, которые вы укажете локально в hub/.env.
Карта квартиры, комнаты, запретные зоны, свои голосовые фразы, громкость голоса, выбор языка и датчик остатка воды в баке не поддерживаются, если их не отдает ваш Tuya-хаб.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Control and query Heiman smart home devices: lights, AC, curtains, climate, logs and scenes.
Yeelight device discovery, state, control, and scene execution.
Control your Tesla from your AI assistant - climate, charging, access, and security.
Unofficial integration! ## ✨ Key Features ### 💰 Financial Intelligence - **Smart Charging Cost An…
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceEnables control and monitoring of a Dreame robot vacuum via MCP tools, including cleaning, status, and map viewing through the cloud API.7MIT
- AlicenseNot gradedqualityCmaintenanceEnables users to control a local-network iRobot Roomba over MQTT without cloud, including status monitoring, mission start/stop/pause/resume, docking, bin emptying, beeping, and plain-language error decoding.1MIT
- AlicenseNot gradedqualityCmaintenanceEnables controlling Roborock vacuums through MCP, exposing status, rooms, cleaning history, consumables, and robot controls.MIT
- AlicenseAqualityCmaintenanceEnables local network control of Tuya and Smart Life smart home devices without cloud round-trips, including power, brightness, color, and raw datapoint operations.9MIT