keenetic-mcp — MCP-сервер для Claude Code: что делает и как установить
MCP-сервер, через который агент читает состояние роутера Keenetic и меняет настройки: устройства, Wi-Fi, сегменты, маршрутизация.
claude mcp add --env KEENETIC_HOST=<KEENETIC_HOST> --env KEENETIC_USER=<KEENETIC_USER> --env KEENETIC_PASSWORD=<KEENETIC_PASSWORD> --transport stdio keenetic-mcp -- npx -y keenetic-mcpЧто делает keenetic-mcp
Сервер говорит с роутером по его HTTP API внутри локальной сети, ставить что-либо на Keenetic не нужно. На чтение он отдаёт устройства с трафиком и уровнем сигнала, интерфейсы и WireGuard-туннели, состояние радио и интернета, таблицу маршрутов и политики. На запись умеет переименовать или заблокировать устройство, поднять и опустить интерфейс, собрать сегмент с Wi-Fi и DHCP. Для остального есть rci_call с произвольным путём API.
Записи попадают в рабочую конфигурацию и откатываются при перезагрузке, пока не вызван save_config: сам сервер его не вызывает. Перед первым изменением за сессию он снимает бэкап, а результат каждого изменения перечитывает, потому что роутер часть неверных команд принимает молча и ничего не меняет. С флагом --read-only инструменты записи вообще не регистрируются, так что агент их не видит.
Настройку проще начать с npx -y keenetic-mcp init: мастер находит роутер по шлюзу по умолчанию, сверяет пароль и кладёт его в системный keychain. В контейнере вместо мастера задают KEENETIC_HOST, KEENETIC_USER и KEENETIC_PASSWORD. В комплекте четыре скилла: дерево RCI, безопасные изменения, сборка сегментов и порядок диагностики.
Какие задачи решает
- найти устройство, которое съедает канал прямо сейчас
- заблокировать камеру до утра, не сохраняя изменение навсегда
- поднять изолированную сеть для гостей или IoT с DHCP
- посмотреть, какие правки в конфигурации ещё не сохранены
- пройти по шагам, когда интернет пропал и непонятно, какая проверка упала
Примеры запросов агенту
- Кто сейчас больше всех качает? Отсортируй по трафику и покажи сигнал.
- Заблокируй
hallway-cameraи скажи, сохранено изменение или откатится после перезагрузки. - Собери сегмент
guestс Wi-Fi и DHCP, маршрутизацию через VPN не включай.
Как установить keenetic-mcp
Командой платформы
claude mcp add --env KEENETIC_HOST=<KEENETIC_HOST> --env KEENETIC_USER=<KEENETIC_USER> --env KEENETIC_PASSWORD=<KEENETIC_PASSWORD> --transport stdio keenetic-mcp -- npx -y keenetic-mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add keenetic-mcp --env KEENETIC_HOST=<KEENETIC_HOST> --env KEENETIC_USER=<KEENETIC_USER> --env KEENETIC_PASSWORD=<KEENETIC_PASSWORD> -- npx -y keenetic-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"keenetic-mcp": {
"command": "npx",
"args": [
"-y",
"keenetic-mcp"
],
"env": {
"KEENETIC_HOST": "<KEENETIC_HOST>",
"KEENETIC_USER": "<KEENETIC_USER>",
"KEENETIC_PASSWORD": "<KEENETIC_PASSWORD>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"keenetic-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"keenetic-mcp"
],
"env": {
"KEENETIC_HOST": "<KEENETIC_HOST>",
"KEENETIC_USER": "<KEENETIC_USER>",
"KEENETIC_PASSWORD": "<KEENETIC_PASSWORD>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e KEENETIC_HOST=<KEENETIC_HOST> -e KEENETIC_USER=<KEENETIC_USER> -e KEENETIC_PASSWORD=<KEENETIC_PASSWORD> keenetic-mcp npx -y keenetic-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о keenetic-mcp
Как установить keenetic-mcp в Claude Code?
Одной командой: `claude mcp add --env KEENETIC_HOST=<KEENETIC_HOST> --env KEENETIC_USER=<KEENETIC_USER> --env KEENETIC_PASSWORD=<KEENETIC_PASSWORD> --transport stdio keenetic-mcp -- npx -y keenetic-mcp`. Подставьте адрес роутера, логин и пароль на место плейсхолдеров.
Что делает keenetic-mcp?
Даёт агенту инструменты чтения и записи для Keenetic: список устройств и их трафик, интерфейсы, Wi-Fi, сегменты, политики маршрутизации. Изменения применяются к рабочей конфигурации и проверяются чтением.
Нужно ли что-то ставить на роутер?
Нет. Сервер обращается к HTTP API Keenetic по локальной сети, прошивку и Entware трогать не надо. Пароль хранится в системном keychain, наружу уходят только запросы к роутеру.
