agentic-dns

POSIX-нативный движок маршрутизации, диагностики и телеметрии DNS для агентных ИИ-систем (Claude, Cursor, Windsurf, Hermes Agent, Copilot).

agentic-dns — это не имеющий внешних зависимостей сверхбыстрый движок оркестрации DNS, написанный на чистом Bash и Rust. Он предназначен для рабочих станций разработчиков, домашних лабораторий, узлов Kubernetes и автономных ИИ-агентов; управляет многоуровневыми DNS-цепочками (pihole -> coredns -> dnsdist -> unbound -> dnscrypt -> VPN DNS), выполняет живую поэтапную трассировку пакетов (trace), автоматически обходит неисправные вышестоящие резолверы (bypass) и предоставляет stdio-сервер Model Context Protocol (MCP JSON-RPC) для ИИ-ассистентов программирования.

Быстрые способы установки

Вариант 1: скрипт в одну строку (Linux / macOS)

curl -fsSL https://raw.githubusercontent.com/dedsecorg/agentic-dns/main/install.sh | bash

Вариант 2: Docker-контейнер (GHCR)

docker run -d --net=host ghcr.io/dedsecorg/agentic-dns:latest

Вариант 3: пакет Node.js / npx

npx agentic-dns status

Related MCP server: dns-mcp

Онбординг ИИ-агента за 60 секунд

agentic-dns из коробки поддерживает протокол MCP JSON-RPC для ИИ-агентов.

1. Claude Code

claude mcp add agentic-dns agentic-dns mcp

2. Cursor / Windsurf / Copilot

Добавьте в файл .mcp.json вашего проекта или пользователя:

{
  "mcpServers": {
    "agentic-dns": {
      "command": "agentic-dns",
      "args": [
        "mcp"
      ],
      "env": {
        "PIHOLE_HOST": "127.0.0.1",
        "AGENTIC_DNS_API_PORT": "8099"
      }
    }
  }
}

3. Hermes Agent

Выполните hermes mcp add agentic-dns agentic-dns mcp.

Примеры промптов для ИИ-ассистента

После подключения вы можете попросить вашего ИИ-ассистента программирования:

• "Проверь, не отключены ли или не работают ли локальные DNS-резолверы в цепочке."

• "Трассируй путь пакетов для github.com через loopback и исходящие интерфейсы."

• "Обойди stubby и направь DNS-трафик через unbound."

• "Покажи недавнюю статистику запросов Pi-hole из SQLite."

Ключевые возможности

• Нулевая зависимость от внешних компонентов: выполнение на чистом POSIX Bash + стандартные Unix-инструменты (dig, ss, tcpdump, nft, sqlite3, socat, jq). Нулевое потребление RAM в состоянии простоя.

• Нативный Model Context Protocol (MCP): предоставляет ИИ-агентам методы dns_status, dns_query, dns_trace, dns_health, dns_routes, dns_pihole_log и dns_bypass.

• Живая межсервисная трассировка (trace): запускает фоновый захват пакетов tcpdump на loopback и сетевых интерфейсах, чтобы визуализировать продвижение пакетов по хопам и узкие места задержки.

• Автоматический переход на резерв при сбоях (bypass): динамически перезаписывает конфигурацию dnsdist и перезагружает демоны маршрутизации, чтобы обходить неисправные резолверы за миллисекунды.

• Перехват зашифрованного DNS (enforce): применяет неразрушающие правила nftables для перенаправления Private DNS (DoT, порт 853) и отбрасывания Google DoQ (UDP/443).

• Высокопроизводительный Rust-сервер (agentic-dns-server): включает крейт server/ для проксирования DoT/DoH и REST-телеметрии.

6-уровневый конвейер архитектуры

  [Client / Mobile Device]
            |
            v
      pihole (:53)          <- Ad blocking & FTL SQLite telemetry
            |
            v
     coredns (:5352)        <- Split-horizon mesh zone routing (Tailscale / Nebula)
            |
            v
     dnsdist (:5330)        <- Dynamic load balancing & bypass failover policy
            |
   +--------+--------+
   |                 |
   v                 v
unbound (:5335)   dnscrypt-proxy (:5354) / stubby (:5360)
   |                 |
   v                 v
[VPN / Upstream]  [DoH / DoT Cloud Upstreams]

Краткий справочник команд CLI

# View active DNS chain status and listening ports
agentic-dns status

# Execute live inter-service packet trace
agentic-dns trace google.com

# Failover failing service to backup
agentic-dns bypass stubby unbound

# Check health of all DNS listeners
agentic-dns health

# View Pi-hole query logs
agentic-dns pihole-log

# Start REST API server on port 8099
agentic-dns api

# Start stdio MCP JSON-RPC Server
agentic-dns mcp

Лицензия

MIT License - бесплатное и открытое программное обеспечение.