go-unifi-mcp — MCP-сервер для Claude Code: управление UniFi
MCP-сервер на Go, который даёт ИИ-ассистенту доступ к UniFi Network Controller: сайты, устройства, клиенты, сети, проброс портов, DNS и правила файрвола.
claude mcp add go-unifi-mcp -- docker run -i --rm ghcr.io/claytono/go-unifi-mcp:v0.3.1Что делает go-unifi-mcp
Сервер оборачивает библиотеку go-unifi и генерирует инструменты из API самого контроллера. Поэтому покрытие операций обновляется вместе с версией UniFi, которую поддерживает go-unifi. Автор сделал проект, потому что не нашёл готового MCP-сервера с поддержкой правил файрвола v1 и v2 сразу и IPv6.
По умолчанию работает ленивый режим: регистрируются три мета-инструмента — tool_index для поиска по каталогу, execute для запуска одного инструмента и batch для параллельного запуска нескольких. Через них доступны 252 операции контроллера. Режим eager регистрирует все 252 инструмента напрямую и съедает около 55K токенов контекста — это для отладки или клиентов без LLM.
Перед запуском нужен доступ к контроллеру: либо API-ключ, либо локальный админ с логином и паролем. Задайте UNIFI_HOST и UNIFI_API_KEY (ключ создаётся в контроллере в Settings > Control Plane > Integrations), либо UNIFI_HOST, UNIFI_USERNAME и UNIFI_PASSWORD. Обновления идут по схеме read-modify-write: сервер читает текущий объект, подставляет ваши поля и отправляет целиком. Без UNIFI_HOST сервер не подключится к контроллеру.
Какие задачи решает
- посмотреть список клиентов и устройств в сети UniFi
- создать правило файрвола v2 или IPv6-правило
- настроить проброс портов через агента
- проверить DNS-записи на контроллере
- выполнить несколько операций UniFi одной пачкой
Примеры запросов агенту
- Покажи все устройства в сайте
defaultи их статус - Добавь правило файрвола v2, разрешающее трафик из VLAN 20 в VLAN 30
- Настрой проброс порта 8443 на клиента
nas
Как установить go-unifi-mcp
Командой платформы
claude mcp add go-unifi-mcp -- docker run -i --rm ghcr.io/claytono/go-unifi-mcp:v0.3.1Командой платформы
codex mcp add go-unifi-mcp -- docker run -i --rm ghcr.io/claytono/go-unifi-mcp:v0.3.1Файл настроек
{
"mcpServers": {
"go-unifi-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/claytono/go-unifi-mcp:v0.3.1"
]
}
}
}Файл настроек
{
"servers": {
"go-unifi-mcp": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/claytono/go-unifi-mcp:v0.3.1"
]
}
}
}Командой платформы
gemini mcp add go-unifi-mcp docker run -i --rm ghcr.io/claytono/go-unifi-mcp:v0.3.1По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о go-unifi-mcp
Как установить go-unifi-mcp в Claude Code?
Выполните claude mcp add go-unifi-mcp -- docker run -i --rm ghcr.io/claytono/go-unifi-mcp:v0.3.1, затем задайте переменные окружения в шелле перед запуском claude.
Что делает go-unifi-mcp?
Даёт ИИ-ассистенту доступ к UniFi Network Controller: сайты, устройства, клиенты, сети, проброс портов, DNS и правила файрвола. Работает через MCP-инструменты, сгенерированные из API контроллера.
Чем ленивый режим отличается от eager?
В lazy регистрируются три мета-инструмента и доступны все 252 операции — это экономит контекст. В eager все 252 инструмента регистрируются напрямую и занимают около 55K токенов.
