mcp-pihole — MCP-сервер для Claude Code: статистика и блокировка DNS
Подключает Pi-hole v6 к ИИ-ассистенту: статистика запросов, белые и чёрные списки, включение и выключение блокировки через обычные фразы.
claude mcp add mcp-pihole -e PIHOLE_URL=<PIHOLE_URL> -e PIHOLE_PASSWORD=<PIHOLE_PASSWORD> -- npx -y mcp-pihole-serverЧто делает mcp-pihole
Сервер связывает ассистента с вашим Pi-hole по API v6. Спросите про топ заблокированных доменов или активных клиентов — получите цифры. Попросите выключить блокировку на пять минут — выключит. Списки доменов правятся без захода в веб-интерфейс.
Внутри набор инструментов: pihole_get_stats, pihole_get_top_blocked, pihole_get_top_clients, pihole_get_query_log, управление блокировкой, CRUD для белого и чёрного списков, обновление gravity и сброс DNS-кеша. У четырёх инструментов статистики есть параметр visualize: true — тогда вместо JSON вернётся ASCII-дашборд с цветными полосами прямо в терминале.
Нужен Node.js 18+ и Pi-hole v6 с включённым API. Пароль приложения генерируется в настройках Pi-hole и показывается один раз — без него сервер не авторизуется. Машина, где запущен ассистент, должна видеть Pi-hole по сети.
Какие задачи решает
- посмотреть топ заблокированных доменов за период
- выключить блокировку на время и вернуть обратно
- добавить домен в белый список без веб-интерфейса
- разобраться, какие клиенты генерируют больше всего запросов
- обновить gravity и сбросить DNS-кеш
Примеры запросов агенту
- Покажи статистику Pi-hole
- Выключи блокировку на 5 минут
- Добавь example.com в белый список
Как установить mcp-pihole
Командой платформы
claude mcp add mcp-pihole -e PIHOLE_URL=<PIHOLE_URL> -e PIHOLE_PASSWORD=<PIHOLE_PASSWORD> -- npx -y mcp-pihole-serverВместо <…> подставьте свои значения
Командой платформы
codex mcp add mcp-pihole --env PIHOLE_URL=<PIHOLE_URL> --env PIHOLE_PASSWORD=<PIHOLE_PASSWORD> -- npx -y mcp-pihole-serverВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"mcp-pihole": {
"command": "npx",
"args": [
"-y",
"mcp-pihole-server"
],
"env": {
"PIHOLE_URL": "<PIHOLE_URL>",
"PIHOLE_PASSWORD": "<PIHOLE_PASSWORD>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"mcp-pihole": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mcp-pihole-server"
],
"env": {
"PIHOLE_URL": "<PIHOLE_URL>",
"PIHOLE_PASSWORD": "<PIHOLE_PASSWORD>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e PIHOLE_URL=<PIHOLE_URL> -e PIHOLE_PASSWORD=<PIHOLE_PASSWORD> mcp-pihole npx -y mcp-pihole-serverВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-pihole
Как установить mcp-pihole в Claude Code?
Выполните claude mcp add mcp-pihole -e PIHOLE_URL=<PIHOLE_URL> -e PIHOLE_PASSWORD=<PIHOLE_PASSWORD> -- npx -y mcp-pihole-server. Подставьте адрес веб-интерфейса Pi-hole и пароль приложения.
Что делает mcp-pihole?
Даёт ассистенту доступ к Pi-hole: статистика запросов, топ доменов и клиентов, журнал DNS-запросов, управление блокировкой, белые и чёрные списки, обновление gravity и сброс кеша.
Что нужно для работы mcp-pihole?
Node.js 18+, Pi-hole v6 с включённым API и пароль приложения из настроек. Переменные PIHOLE_URL и PIHOLE_PASSWORD передаются при добавлении сервера.
