SwitchBot CLI
CLI для умного дома SwitchBot: устройства и сцены из терминала, MCP-сервер для Claude Code, Codex и Gemini CLI.
- 136 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Управляет физическими устройствами: замками, гаражными воротами, розетками.
- Хранит токен и секрет SwitchBot в связке ключей ОС или в `~/.switchbot/config.json`.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/switchbot-cliОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Управляет физическими устройствами: замками, гаражными воротами, розетками.
- Хранит токен и секрет SwitchBot в связке ключей ОС или в `~/.switchbot/config.json`.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Пакет `@switchbot/openapi-cli` дает команду `switchbot` для устройств, сцен и потока событий SwitchBot. Одна и та же база устройств, кеш и подпись запросов HMAC работают и для человека, и для скриптов, и для агента. Для агента есть `switchbot mcp serve` с 18 инструментами по умолчанию, 15 в режиме только чтения и 29 с флагом `--tools all`. Команды `switchbot claude-code setup`, `codex setup` и `gemini setup` сами регистрируют сервер и открывают вход в браузере, ключи хранятся в связке ключей ОС. Для опасных команд есть защита: `--dry-run`, `--require-approval` и журнал `--audit-log`.
Для кого. Владельцы умного дома SwitchBot, которые хотят управлять светом, шторами и замками из чата с агентом или скриптом.
Подходит, если
- Агент включает сцену вечернего света одной фразой.
- Нужен список устройств в формате JSON для скрипта.
- Датчики открытия двери читают через поток событий MQTT.
- Опасные команды сначала проверяют флагом `--dry-run`.
Не подходит, если
- Устройства другого производителя.
- Замок или гаражные ворота нельзя открывать без подтверждения человека.
- Node.js старше 18 версии недоступен.
Пример запроса к агенту
Покажи мои устройства SwitchBot и выключи свет в гостиной, сначала проверив команду флагом `--dry-run`.Ограничения
Нужен Node.js 18 или новее и аккаунт SwitchBot. Камеры дают только статус, датчики и хабы работают на чтение. Возможности устройств взяты из официальной документации API, поведение не задокументированных режимов проект не гарантирует. Плагины для Codex и Gemini версии 0.2.0 требуют CLI от 3.9.0. Расширение для Gemini CLI подключают через `gemini extensions link`, а плагин Codex ставят отдельным пакетом. Автоматизации по политике требуют настройки `policy.yaml`.
Как отключить. Удалите MCP-сервер из конфигурации клиента, выполните `npm uninstall -g @switchbot/openapi-cli` и сотрите ключи из связки ключей командой `switchbot auth keychain delete`.
Частые вопросы
Как подключить SwitchBot к Claude Code?
Выполните `npx @switchbot/openapi-cli claude-code setup` и перезапустите Claude Code. Команда ставит CLI, регистрирует MCP-сервер через `claude mcp add --scope user` и открывает вход в браузере.
Нужно ли копировать токен из приложения?
Нет, достаточно `switchbot auth login`. Токен и секрет из приложения нужны только для ручной настройки командой `switchbot config set-token`.
Сколько инструментов у MCP-сервера?
По умолчанию 18, в режиме только чтения 15, с флагом `--tools all` 29.
Как проверить установку?
Выполните `switchbot doctor`: 22 проверки покрывают Node, ключи, MQTT, политику и журнал.
Как защитить замок от случайной команды?
Проверьте команду флагом `--dry-run`, включите `--require-approval` в `plan run` и ведите журнал `--audit-log`. В режиме только чтения MCP-сервер не отправляет команды.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыMCP-сервер в одном бинарнике на Go: больше 75 локальных инструментов для файлов, оболочки, браузера и календаря
Плагин для Claude Code и MCP-сервер: агент включает свет, запирает замки и запускает сценарии Apple HomeKit на Mac
Подключает Claude Code, Cursor, Codex или OpenCode к Telegram, Slack и Discord: коллеги пишут боту, отвечает кодовый агент
Discord MCP от cappyeo — более 200 инструментов
Discord MCP (cappyeo)
Discord MCP с более чем 200 инструментами: агент ведет сообщения, роли и модерацию, собирает сервер по плану, а запись по умолчанию в режиме предпросмотра
MCP-сервер на Node.js, через который агент управляет устройствами Home Assistant и правит его автоматизации
Hycli по адресу сайта и цели собирает типизированный CLI и MCP-инструменты, работая в вашей браузерной сессии без утечки куки.
Коротко о README
Три входа: человеку (таблицы, подсказки, автодополнение), скрипту (`--json`, коды выхода, журнал) и агенту (`mcp serve`, `schema export`, `plan run`). Политики автоматизации лежат в `policy.yaml`.