# genieacs-mcp

MCP-сервер, который подключает ИИ-клиент к GenieACS и даёт искать устройства, читать их параметры и ставить задачи прямо из чата.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 19
- Автор: GeiserX
- Лицензия: GPL-3.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/GeiserX/genieacs-mcp
- Обновлён: 2026-10-21
- HTML: https://affpapa.org/nevibecode/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 с симулированным роутером примерно за минуту.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `ACS_URL`, `ACS_USER`, `ACS_PASS`, `DEVICE_LIMIT` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
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

**Командой платформы**
```bash
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
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "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>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "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 CLI

**Командой платформы**
```bash
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
```
Вместо <…> подставьте свои значения

## Когда брать
- найти устройства, которые перестали выходить на связь
- посмотреть дерево параметров конкретного CPE
- перезагрузить устройства с нужным тегом
- раздать прошивку на парк роутеров
- создать пресет или провижен из чата

## Примеры запросов агенту
- Какие устройства перестали информировать ACS прошлой ночью?
- Перезагрузи все устройства с тегом `pilot`
- Покажи параметры устройства `202BC1-BM632w-000000`

## Похожие
- [GitHub](https://affpapa.org/nevibecode/mcp/github.md) — MCP-сервер · ★ 33918
- [Netdata](https://affpapa.org/nevibecode/mcp/netdata.md) — MCP-сервер · ★ 81115
- [Oh My Posh Validator](https://affpapa.org/nevibecode/mcp/oh-my-posh-validator.md) — MCP-сервер · ★ 23643
- [Keploy](https://affpapa.org/nevibecode/mcp/keploy.md) — MCP-сервер · ★ 18727
- [Coder](https://affpapa.org/nevibecode/mcp/coder.md) — MCP-сервер · ★ 17160
- [mcp](https://affpapa.org/nevibecode/mcp/kubeshark-mcp.md) — MCP-сервер · ★ 12109

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md