keenetic-mcp — управление роутером Keenetic
keenetic-mcp
MCP-сервер для роутеров Keenetic: агент смотрит устройства и Wi-Fi, меняет правила через API RCI и ничего не ставит на сам роутер
- 29 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Агент получает пароль администратора роутера и может блокировать устройства, отключать интерфейсы и создавать сети
- Неосторожное отключение интерфейса или удаление сегмента способно оборвать собственный доступ к роутеру
Установка
- Работает в
Ручная установка
/plugin marketplace add salatmaster/keenetic-mcp
/plugin install keenetic@keeneticЗатем запустите мастер: npx -y keenetic-mcp init.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент получает пароль администратора роутера и может блокировать устройства, отключать интерфейсы и создавать сети
- Неосторожное отключение интерфейса или удаление сегмента способно оборвать собственный доступ к роутеру
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер обращается к встроенному HTTP-интерфейсу RCI в KeeneticOS по локальной сети, поэтому на роутер не нужны ни USB-накопитель, ни Entware, ни прошивка. Агент по запросу показывает, кто сейчас грузит канал, какой сигнал у устройства, доступен ли интернет и что в таблице маршрутов. На запись есть инструменты update_device (переименовать, заблокировать, назначить политику маршрутизации, расписание или приоритет), set_interface_state, create_segment и delete_segment для гостевой или IoT-сети с Wi-Fi, DHCP и VPN, а также save_config. Изменения применяются к рабочей конфигурации и пропадают при перезагрузке, пока вы не попросите сохранить. Перед первой правкой в сессии сервер делает резервную копию, а каждую запись читает обратно и сверяет. Запасной инструмент rci_call вызывает любой путь API. В составе плагина четыре скилла (keenetic-rci, keenetic-safe-changes, keenetic-segments, keenetic-troubleshoot): они объясняют агенту дерево API, порядок безопасных правок, сборку изолированных сегментов и диагностику проблем с интернетом и Wi-Fi.
Для кого. Для владельцев и администраторов роутеров Keenetic, которые хотят спрашивать агента о домашней сети обычными словами, не заходя в веб-интерфейс.
Подходит, если
- Нужно выяснить, какое устройство сейчас забирает больше всего трафика
- Хотите временно заблокировать камеру или гаджет по MAC и убедиться, что правило применилось
- Собираете гостевую или IoT-сеть с отдельным Wi-Fi, DHCP и маршрутом через VPN
- Диагностируете «пропал интернет» или «слабый Wi-Fi»: у плагина есть готовый порядок проверок
- Нужна копия конфигурации в локальный файл перед экспериментами
Не подходит, если
- Роутер другого производителя: сервер работает только с RCI в KeeneticOS
- Агент не должен менять сеть: запускайте сервер с флагом --read-only, тогда записывающие инструменты вообще не регистрируются
- Нужен доступ к роутеру извне: сервер ходит только по локальной сети, облачного канала нет
- Вы не готовы дать агенту пароль администратора роутера
Пример запроса к агенту
Покажи устройства, которые сейчас активны, отсортируй по трафику и заблокируй камеру в коридоре до утраMCP
- Транспорт
- stdio
- Авторизация
- ключ необязателен
Переменные окружения
KEENETIC_HOST- Адрес роутера, переопределяет настройки мастера.
KEENETIC_USER- Логин администратора роутера.
KEENETIC_PASSWORDсекрет- Пароль администратора, удобен для контейнеров; иначе берется из связки ключей.
Ограничения
Нужны Node.js для npx и учетная запись администратора роутера. Проверено на Keenetic Ultra (KN-1811) с KeeneticOS 5.1.3; на других моделях набор инструментов подстраивается под доступные компоненты. Публичной документации RCI нет, поэтому часть путей API описана в заметках docs/rci-api.md. Неверные команды роутер иногда принимает молча, поэтому сервер проверяет каждую запись чтением. Пароль мастер кладет в системную связку ключей, а в файл настроек попадают только адрес и логин. Плагины закреплены на ветке `keenetic-mcp@^0`, то есть следуют за основной версией.
Как отключить. Уберите сервер из клиента, например codex mcp remove keenetic или claude mcp remove keenetic, и удалите плагин через /plugin. Пароль лежит в системной связке ключей; его можно стереть оттуда вручную.
Частые вопросы
Как подключить роутер Keenetic к Claude Code через MCP?
Выполните /plugin marketplace add salatmaster/keenetic-mcp и /plugin install keenetic@keenetic, затем в терминале запустите npx -y keenetic-mcp init. Мастер найдет роутер по шлюзу по умолчанию, проверит пароль и сохранит его в связке ключей.
Нужно ли ставить что-то на сам роутер Keenetic?
Нет. Сервер использует встроенный интерфейс RCI по локальной сети, USB-накопитель, Entware и правка прошивки не требуются.
Сохраняются ли изменения на роутере сразу?
Нет, они действуют в рабочей конфигурации и пропадают при перезагрузке, пока не вызван save_config. Сервер сам его не вызывает. Перед первой правкой в сессии он делает резервную копию.
Как запретить агенту менять настройки Keenetic?
Запустите сервер с флагом --read-only. Инструменты записи при этом не регистрируются, агент их не увидит.
Что делает скилл keenetic-segments в плагине?
Он учит агента собирать изолированную сеть, которую роутер действительно покажет в веб-интерфейсе. Сегмент опирается на VLAN, и без нее гостевая сеть передает трафик, но в списке сегментов не появляется.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер для роутеров MikroTik: агент читает и меняет конфигурацию RouterOS по SSH по запросу из чата
Менеджер MCP-серверов на Node.js: запускает локальные и подключает удаленные серверы и отдает их клиенту одним адресом с REST API для управления
MCP-сервер для Kubernetes: агент читает состояние кластера, разбирает сбои подов и запускает операции через kubectl
Защищенный MCP-рантайм, через который агент управляет локальными машинами, серверами и контейнерами
Агент управляет серверами через каталог объявленных действий: политика решает, что выполнить, а что ждет человека
MCP-сервер для диагностики Linux: ИИ-клиент читает службы, журналы и сеть локальных и удаленных систем без права записи
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| keenetic-mcp — управление роутером Keenetic (эта запись) | нет | ключ необязателен | 29 | |
| MCP SSH Manager | нет | API-ключ | 527 | подключается к серверам по SSH, а не к роутеру через его API |
| ha-mcp | нет | API-ключ | 5 333 | управляет умным домом в Home Assistant, не сетью роутера |
Коротко о README
Описаны установка для Claude Code и Codex, универсальный JSON для остальных клиентов и мастер первичной настройки с хранением пароля в связке ключей. Далее таблицы инструментов на чтение, на запись и запасной rci_call, раздел о безопасности и список проверенных моделей. Отдельно рассказано, как устроен RCI и где хранятся заметки по его API.