agentic-dns

Agentic AIシステム（Claude、Cursor、Windsurf、Hermes Agent、Copilot）向けのPOSIXネイティブDNSルーティング、診断、テレメトリエンジン。

agentic-dns は、純粋なBashとRustで書かれた、依存関係ゼロの超高速DNSオーケストレーションエンジンです。開発者ワークステーション、ホームラボ、Kubernetesノード、自律型AIエージェント向けに設計されており、多層DNSチェーン（pihole -> coredns -> dnsdist -> unbound -> dnscrypt -> VPN DNS）を管理し、ライブのホップバイホップパケットトレース（trace）を実行し、障害が発生したアップストリームを自動的にバイパスし（bypass）、AIコーディングアシスタント用の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秒AIエージェントオンボーディング

agentic-dns は、AIエージェント向けにすぐ使える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 を実行します。

AIアシスタントプロンプトの例

接続すると、AIコーディングアシスタントに次のように依頼できます：

• "チェーン内のローカルDNSリゾルバーがダウンまたは異常でないか確認して。"

• "ループバックおよびアウトバウンドインターフェースをまたいで github.com のパケット経路をトレースして。"

• "stubby をバイパスして、DNSトラフィックを unbound 経由でルーティングして。"

• "SQLite から最近のPi-holeクエリ統計を表示して。"

主な機能

• 外部依存関係ゼロ: コア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 をAIエージェントに公開します。

• ライブサービス間トレーシング（trace）: ループバックおよびネットワークインターフェース全体でバックグラウンドの tcpdump キャプチャを実行し、パケットホップの進行とレイテンシボトルネックを可視化します。

• 自動フェイルオーバー（bypass）: dnsdist 設定を動的に書き換え、ルーティングデーモンをリロードして、障害が発生したリゾルバーをミリ秒単位でバイパスします。

• 暗号化DNSインターセプト（enforce）: 非破壊的な nftables ルールを適用して、Private DNS（DoTポート853）をリダイレクトし、Google DoQ（UDP/443）をドロップします。

• 高性能Rustサーバー（agentic-dns-server）: DoT/DoHプロキシ処理とRESTテレメトリ用の server/ クレートを含みます。

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 - 無料かつオープンソース。