AdGuard Home MCP Server — MCP-сервер для Claude Code: установка
MCP-сервер связывает ИИ-агента с AdGuard Home для управления DNS-фильтрацией, клиентами, DHCP и правилами переписывания.
claude mcp add mcp-adguard-home -e ADGUARD_URL=<ADGUARD_URL> -e ADGUARD_USERNAME=<ADGUARD_USERNAME> -e ADGUARD_PASSWORD=<ADGUARD_PASSWORD> -- npx -y @samik081/mcp-adguard-homeЧто делает AdGuard Home MCP Server
Сервер даёт ИИ-агенту инструменты для работы с AdGuard Home через естественный язык. Он охватывает DNS-фильтрацию, журналы запросов, статистику, клиентов, DHCP, переписывание адресов и другие категории. Всего доступно 65 инструментов в 16 категориях.
Режим full разрешает чтение и изменения, включая операции с фильтрами и журналами. Для мониторинга можно задать ADGUARD_ACCESS_TIER=read-only: тогда агент получит 29 инструментов без изменения состояния. Список доступных категорий и инструментов дополнительно ограничивается переменными окружения.
Сервер запускается через npx или Docker, поддерживает stdio и HTTP-транспорт. Для подключения нужен ADGUARD_URL; имя и пароль администратора задаются, когда в AdGuard Home включена аутентификация. При старте сервер проверяет соединение, поэтому неверные учётные данные остановят запуск сразу.
Какие задачи решает
- управлять DNS-фильтрацией через ИИ-агента
- просматривать журналы DNS-запросов и статистику
- настраивать клиентов и DHCP
- изменять правила переписывания адресов
- ограничивать доступ агента режимом только чтения
Примеры запросов агенту
- Покажи текущие настройки DNS в AdGuard Home и последние записи журнала запросов.
- Добавь правило переписывания для указанного домена в AdGuard Home.
- Проверь клиентов и DHCP, но не меняй состояние сервера.
Как установить AdGuard Home MCP Server
Командой платформы
claude mcp add mcp-adguard-home -e ADGUARD_URL=<ADGUARD_URL> -e ADGUARD_USERNAME=<ADGUARD_USERNAME> -e ADGUARD_PASSWORD=<ADGUARD_PASSWORD> -- npx -y @samik081/mcp-adguard-homeВместо <…> подставьте свои значения
Командой платформы
codex mcp add adguard-home-mcp-server --env ADGUARD_URL=<ADGUARD_URL> --env ADGUARD_USERNAME=<ADGUARD_USERNAME> --env ADGUARD_PASSWORD=<ADGUARD_PASSWORD> -- npx -y @samik081/mcp-adguard-homeВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"adguard-home-mcp-server": {
"command": "npx",
"args": [
"-y",
"@samik081/mcp-adguard-home"
],
"env": {
"ADGUARD_URL": "<ADGUARD_URL>",
"ADGUARD_USERNAME": "<ADGUARD_USERNAME>",
"ADGUARD_PASSWORD": "<ADGUARD_PASSWORD>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"adguard-home-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@samik081/mcp-adguard-home"
],
"env": {
"ADGUARD_URL": "<ADGUARD_URL>",
"ADGUARD_USERNAME": "<ADGUARD_USERNAME>",
"ADGUARD_PASSWORD": "<ADGUARD_PASSWORD>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e ADGUARD_URL=<ADGUARD_URL> -e ADGUARD_USERNAME=<ADGUARD_USERNAME> -e ADGUARD_PASSWORD=<ADGUARD_PASSWORD> adguard-home-mcp-server npx -y @samik081/mcp-adguard-homeВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о AdGuard Home MCP Server
Как установить AdGuard Home MCP Server в Claude Code?
Выполните `claude mcp add mcp-adguard-home -e ADGUARD_URL=<ADGUARD_URL> -e ADGUARD_USERNAME=<ADGUARD_USERNAME> -e ADGUARD_PASSWORD=<ADGUARD_PASSWORD> -- npx -y @samik081/mcp-adguard-home`.
Что делает AdGuard Home MCP Server?
Он подключает ИИ-агента к AdGuard Home и открывает инструменты для DNS-фильтрации, журналов, клиентов, DHCP и других настроек.
Можно ли подключить сервер только для мониторинга?
Да. Переменная ADGUARD_ACCESS_TIER=read-only оставляет 29 инструментов чтения и блокирует изменения состояния.
