dns-mcp

Un servidor del Model Context Protocol que permite a cualquier cliente MCP (Claude Desktop, Claude Code, Cursor, etc.) realizar búsquedas de DNS, WHOIS y geolocalización de IP durante una conversación.

Pregúntale a Claude "¿por qué foo.com no es accesible desde Tokio?" y podrá consultar los registros, verificar el WHOIS y geolocalizar la IP sin salir del chat.

Características

• [x] resolve_dns — búsqueda directa mediante DNS-over-HTTPS (A, AAAA, CNAME, MX, TXT, NS, SOA, PTR, SRV, CAA)

• [x] reverse_dns — búsqueda PTR para IPv4 o IPv6

• [x] whois_domain — información de registro estructurada mediante RDAP (WHOIS moderno)

• [x] geo_ip — país / ciudad / ASN / ISP para una IP pública

• [ ] Consultas masivas / transferencia de zona

• [ ] Salida de validación DNSSEC

• [ ] Caché local (reduce las llamadas repetidas a los proveedores upstream)

No se requieren claves API. Las cuatro herramientas utilizan puntos finales públicos gratuitos:

Related MCP server: intodns-mcp

Inicio rápido

Instalación

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

Claude Desktop

Añadir a claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\):

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

Reinicia Claude Desktop; las cuatro herramientas deberían aparecer en el menú de herramientas.

Claude Code

claude mcp add dns dns-mcp

Codex CLI

Añadir a ~/.codex/config.toml:

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

Reinicia Codex. Las cuatro herramientas estarán disponibles en cualquier sesión de Codex.

Ejecutar desde el código fuente

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

Ejemplos de prompts

• "¿Cuáles son los registros A y MX de github.com?"

• "¿Quién registró cloudflare.com y cuándo caduca?"

• "Geolocaliza 140.82.121.4 — ¿qué país e ISP tiene?"

• "Mis usuarios en Tokio dicen que foo.com es lento. Resuélvelo y luego geolocaliza la IP."

• "Recibí un correo electrónico de support@paypa1-security.com. ¿Es ese dominio sospechoso?"

Desarrollo

uv sync
uv run pytest
uv run ruff check .

Depuración interactiva con el Inspector MCP:

npx @modelcontextprotocol/inspector uv run dns-mcp

Una nota sobre ip-api.com

El nivel gratuito de ip-api.com requiere HTTP (no HTTPS). Esto está bien para geolocalizar IPs públicas arbitrarias —no se envían credenciales— pero significa que la solicitud es visible en la red. Si esto es una preocupación en tu entorno, cambia a una alternativa HTTPS (por ejemplo, ipwho.is, ipinfo.io con un token) editando IPGEO_URL en src/dns_mcp/__init__.py.

Licencia

MIT — ver LICENSE.