genieacs-mcp — MCP-сервер для Claude Code
MCP-сервер, который подключает ИИ-клиент к GenieACS и даёт искать устройства, читать их параметры и ставить задачи прямо из чата.
claude mcp add --env ACS_URL=<ACS_URL> --env ACS_USER=<ACS_USER> --env ACS_PASS=<ACS_PASS> --env DEVICE_LIMIT=<DEVICE_LIMIT> --transport stdio genieacs-mcp -- npx -y genieacs-mcpЧто делает genieacs-mcp
Сервер работает поверх NBI GenieACS и отдаёт ассистенту 7 ресурсов и 12 инструментов. Через них можно искать устройства по тегу, модели, прошивке или любому параметру TR-069, читать дерево параметров, задачи и ошибки, а также смотреть пресеты, провижены и файлы на ACS. Действия вроде перезагрузки, обновления прошивки, смены параметра или connection request тоже доступны из чата.
Инструменты разделены на чтение и действия: search_devices, get_parameter и ресурсы ничего не меняют, остальные десять ставят задачу на устройство или правят ACS. Режима только для чтения нет, поэтому указывайте ACS, на котором ассистенту действительно можно действовать, и не отключайте подтверждение вызова инструментов в клиенте. HTTP-транспорт по умолчанию слушает только loopback, а Host и Origin проверяются на DNS rebinding.
Ставится одним бинарником на Go под Linux, macOS и Windows (amd64 и arm64), есть npm-пакет и образ Docker. Для запуска нужен доступ к NBI GenieACS на порту 7557 — без него сервер работать не будет. Если своего ACS нет, демо-стек из genieacs-container поднимает ACS с симулированным роутером примерно за минуту.
Какие задачи решает
- найти устройства, которые перестали выходить на связь
- посмотреть дерево параметров конкретного CPE
- перезагрузить устройства с нужным тегом
- раздать прошивку на парк роутеров
- создать пресет или провижен из чата
Примеры запросов агенту
- Какие устройства перестали информировать ACS прошлой ночью?
- Перезагрузи все устройства с тегом
pilot - Покажи параметры устройства
202BC1-BM632w-000000
Как установить genieacs-mcp
Командой платформы
claude mcp add --env ACS_URL=<ACS_URL> --env ACS_USER=<ACS_USER> --env ACS_PASS=<ACS_PASS> --env DEVICE_LIMIT=<DEVICE_LIMIT> --transport stdio genieacs-mcp -- npx -y genieacs-mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add genieacs-mcp --env ACS_URL=<ACS_URL> --env ACS_USER=<ACS_USER> --env ACS_PASS=<ACS_PASS> --env DEVICE_LIMIT=<DEVICE_LIMIT> -- npx -y genieacs-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"genieacs-mcp": {
"command": "npx",
"args": [
"-y",
"genieacs-mcp"
],
"env": {
"ACS_URL": "<ACS_URL>",
"ACS_USER": "<ACS_USER>",
"ACS_PASS": "<ACS_PASS>",
"DEVICE_LIMIT": "<DEVICE_LIMIT>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"genieacs-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"genieacs-mcp"
],
"env": {
"ACS_URL": "<ACS_URL>",
"ACS_USER": "<ACS_USER>",
"ACS_PASS": "<ACS_PASS>",
"DEVICE_LIMIT": "<DEVICE_LIMIT>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e ACS_URL=<ACS_URL> -e ACS_USER=<ACS_USER> -e ACS_PASS=<ACS_PASS> -e DEVICE_LIMIT=<DEVICE_LIMIT> genieacs-mcp npx -y genieacs-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о genieacs-mcp
Как установить genieacs-mcp в Claude Code?
Выполните claude mcp add genieacs-mcp -e ACS_URL=<ACS_URL> -e ACS_PASS=<ACS_PASS> -- npx -y genieacs-mcp. Если нужны логин и лимит устройств, есть второй вариант с ACS_USER и DEVICE_LIMIT.
Что делает genieacs-mcp?
Связывает ИИ-клиент с NBI GenieACS: ассистент ищет устройства, читает параметры и задачи, а также перезагружает CPE, ставит прошивку и правит настройки ACS.
Нужен ли свой GenieACS?
Да, серверу нужен доступ к NBI на порту 7557. Для проверки можно поднять демо-стек из genieacs-container с симулированным роутером.
