agentic-dns

POSIX-native DNS-Routing-, Diagnose- und Telemetrie-Engine für agentische KI-Systeme (Claude, Cursor, Windsurf, Hermes Agent, Copilot).

agentic-dns ist eine ultrachsnelle DNS-Orchestrierungs-Engine ohne Abhängigkeiten, die in reinem Bash und Rust geschrieben ist. Konzipiert für Entwickler-Workstations, Homelabs, Kubernetes-Knoten und autonome KI-Agenten, verwaltet sie mehrstufige DNS-Ketten (pihole -> coredns -> dnsdist -> unbound -> dnscrypt -> VPN DNS), führt Live-Paketverfolgung von Hop zu Hop durch (trace), umgeht automatisch fehlerhafte Upstream-Server (bypass) und stellet einen stdio-Model-Context-Protocol-Server (MCP JSON-RPC) für KI-Codierungsassistenten bereit.

Schnellinstallationsoptionen

Option 1: 1-Zeilen-Skript (Linux / maOS)

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

Option 2: Docker-Container (GHCR)

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

Option 3: Node.js / npx-Paket

npx agentic-dns status

Related MCP server: dns-mcp

60-Sekunden-Onboarding für KI-Agenten

agentic-dns bietet KI-Agenten sofort einsatzbereite Unterstützung für das MCP-JSON-RPC-Protokoll.

1. Claude Code

claude mcp add agentic-dns agentic-dns mcp

2. Cursor / Windsurf / Copilot

Fügen Sie Folgendes zu Ihrer Projekt- oder Benutzerdatei .mcp.json hinzu:

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

3. Hermes Agent

Führen Sie hermes mcp add agentic-dns agentic-dns mcp aus.

Beipiel-Prompts für KI-Assistenten

Sobald die Verbindung hergestellet ist, fragen Sie Ihren KI-Codierungsassistenten:

• "Prüfen Sie, ob lokale DNS-Resolver in der Kette ausgefallen oder nicht gesund sind."

• "Verfolgen Sie den Paketpfad für github.com über Loopback- und ausgehende Schnittstellen."

• "Umgehen Sie stubby und leiten Sie DNS-Datenverkehr über unbound."

• "Zeigen Sie aktuelle Pi-hole-Abfragestatistiken aus SQLite an."

Kernfunktionen

• Null externe Abhängigkeiten: Ausführung über reines POSIX-Bash + Standard-Unix-Tools (dig, ss, tcpdump, nft, sqlite3, socat, jq). Null RAM-Verbrauch im Leerlauf.

• Natives Model Context Protocol (MCP): Stellt dns_status, dns_query, dns_trace, dns_health, dns_routes, dns_pihole_log und dns_bypass für KI-Agenten bereit.

• Live-Tracing zwischen Diensten (trace): Führt im Hintergrund tcpdump-aufzeichnungen über Loopback- und Netzwerkschnittstellen aus, um den Paket-Hop-Verlauf und Latenzengpässe zu visualisieren.

• Automatisches Failover (bypass): Schreibt die dnsdist-Configration dynamisch neu und lädt Routing-Daemons neu, um fehlerhafte Resolver in Millisekunden zu umgehen.

• Verschlüsseltes DNS-Abfangen (enforce): Wendet ncht-destruktive nftables-egeln an, um Private DNS (DoT-Port 853) umzuleiten und Google DoQ (UDP/443) zu verwerfen.

• Hochleistungs-Rust-Server (agentic-dns-server): Enthält die server/-Crate für DoT/DoH-Proxy-Handling und REST-Telemetrie.

6-stufige Architektur-Pipeline

  [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]

Kurzreferenz der CLI-Befehle

# 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

Lizenz

MIT-Lizenz - Frei und Open Source.