dns-mcp

Сервер Model Context Protocol, который позволяет любому MCP-клиенту (Claude Desktop, Claude Code, Cursor и т. д.) выполнять DNS, WHOIS и IP-геолокацию прямо во время диалога.

Спросите Claude: "почему foo.com недоступен из Токио?", и он сможет получить записи, проверить WHOIS и определить геолокацию IP, не покидая чат.

Функции

• [x] resolve_dns — прямой поиск через DNS-over-HTTPS (A, AAAA, CNAME, MX, TXT, NS, SOA, PTR, SRV, CAA)

• [x] reverse_dns — PTR-запрос для IPv4 или IPv6

• [x] whois_domain — структурированная информация о регистрации через RDAP (современный WHOIS)

• [x] geo_ip — страна / город / ASN / ISP для публичного IP

• [ ] Массовые запросы / передача зон

• [ ] Вывод проверки DNSSEC

• [ ] Локальный кэш (для сокращения повторных запросов к вышестоящим серверам)

API-ключи не требуются. Все четыре инструмента обращаются к публичным бесплатным конечным точкам:

Related MCP server: intodns-mcp

Быстрый старт

Установка

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

Claude Desktop

Добавьте в claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\):

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

Перезапустите Claude Desktop; четыре инструмента должны появиться в меню инструментов.

Claude Code

claude mcp add dns dns-mcp

Codex CLI

Добавьте в ~/.codex/config.toml:

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

Перезапустите Codex. После этого четыре инструмента станут доступны в любой сессии Codex.

Запуск из исходного кода

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

Примеры запросов

• "Какие A и MX записи у github.com?"

• "Кто зарегистрировал cloudflare.com и когда истекает срок регистрации?"

• "Определи геолокацию 140.82.121.4 — какая страна и провайдер?"

• "Мои пользователи в Токио говорят, что foo.com работает медленно. Разреши его, а затем определи геолокацию IP."

• "Я получил письмо от support@paypa1-security.com. Этот домен подозрительный?"

Разработка

uv sync
uv run pytest
uv run ruff check .

Интерактивная отладка с помощью MCP Inspector:

npx @modelcontextprotocol/inspector uv run dns-mcp

Примечание о ip-api.com

Бесплатный уровень ip-api.com требует использования HTTP (не HTTPS). Это подходит для геолокации произвольных публичных IP-адресов — учетные данные не передаются — но означает, что запрос виден в сети. Если это вызывает беспокойство в вашей среде, замените его на HTTPS-альтернативу (например, ipwho.is, ipinfo.io с токеном), отредактировав IPGEO_URL в src/dns_mcp/__init__.py.

Лицензия

MIT — см. LICENSE.