dns-mcp

Ein Model Context Protocol-Server, der es jedem MCP-Client (Claude Desktop, Claude Code, Cursor usw.) ermöglicht, DNS-, WHOIS- und IP-Geolokalisierungsabfragen mitten im Gespräch durchzuführen.

Fragen Sie Claude: "Warum ist foo.com von Tokio aus nicht erreichbar?" und er kann tatsächlich die Datensätze abrufen, das WHOIS prüfen und die IP geolokalisieren, ohne den Chat zu verlassen.

Funktionen

• [x] resolve_dns — Forward-Lookup via DNS-over-HTTPS (A, AAAA, CNAME, MX, TXT, NS, SOA, PTR, SRV, CAA)

• [x] reverse_dns — PTR-Lookup für IPv4 oder IPv6

• [x] whois_domain — strukturierte Registrierungsinformationen via RDAP (modernes WHOIS)

• [x] geo_ip — Land / Stadt / ASN / ISP für eine öffentliche IP

• [ ] Bulk- / Zonentransfer-Abfragen

• [ ] DNSSEC-Validierungsausgabe

• [ ] Lokaler Cache (reduziert wiederholte Upstream-Aufrufe)

Keine API-Schlüssel erforderlich. Alle vier Tools greifen auf öffentliche, kostenlose Endpunkte zu:

Related MCP server: intodns-mcp

Schnellstart

Installation

pipx install dns-mcp
# or
uv tool install dns-mcp

Claude Desktop

Fügen Sie dies zu claude_desktop_config.json hinzu (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\):

{
  "mcpServers": {
    "dns": {
      "command": "dns-mcp"
    }
  }
}

Starten Sie Claude Desktop neu; die vier Tools sollten im Tool-Menü erscheinen.

Claude Code

claude mcp add dns dns-mcp

Codex CLI

Fügen Sie dies zu ~/.codex/config.toml hinzu:

[mcp_servers.dns]
command = "dns-mcp"

Starten Sie Codex neu. Die vier Tools sind dann in jeder Codex-Sitzung verfügbar.

Aus dem Quellcode ausführen

git clone https://github.com/r0bin2u/dns-mcp && cd dns-mcp
uv sync
uv run dns-mcp

Beispiel-Prompts

• "Was sind die A- und MX-Einträge von github.com?"

• "Wer hat cloudflare.com registriert und wann läuft die Registrierung ab?"

• "Geolokalisiere 140.82.121.4 — welches Land und welcher ISP?"

• "Meine Benutzer in Tokio sagen, foo.com sei langsam. Löse es auf und geolokalisiere dann die IP."

• "Ich habe eine E-Mail von support@paypa1-security.com erhalten. Ist diese Domain verdächtig?"

Entwicklung

uv sync
uv run pytest
uv run ruff check .

Interaktives Debugging mit dem MCP Inspector:

npx @modelcontextprotocol/inspector uv run dns-mcp

Ein Hinweis zu ip-api.com

Der kostenlose Tarif von ip-api.com erfordert HTTP (nicht HTTPS). Dies ist für die Geolokalisierung beliebiger öffentlicher IPs in Ordnung – es werden keine Anmeldedaten gesendet –, bedeutet aber, dass die Anfrage im Netzwerk sichtbar ist. Wenn dies in Ihrer Umgebung ein Problem darstellt, tauschen Sie es gegen eine HTTPS-Alternative aus (z. B. ipwho.is, ipinfo.io mit einem Token), indem Sie IPGEO_URL in src/dns_mcp/__init__.py bearbeiten.

Lizenz

MIT — siehe LICENSE.