DNS и WHOIS запрос MCP сервер mcp-domaintools

mcp-domaintools — сервер Model Context Protocol (MCP), предоставляющий возможности запросов DNS и WHOIS для помощников ИИ. Он позволяет моделям ИИ выполнять поиск DNS как через локальные DNS-резолверы, так и через удаленные службы DNS-over-HTTPS.

Для локальных DNS-запросов он использует настроенные DNS-серверы системы. Для удаленных DNS-запросов он использует запросы Cloudflare DNS-over-HTTPS с откатом на Google DNS-over-HTTPS. Этого более чем достаточно для большинства случаев использования.

Для пользовательских DNS-over-HTTPS-серверов можно использовать флаг --remote-server-address . Конечная точка сервера должна реализовать формат ответа HTTP, как определено в RFC 8484 .

Для пользовательских серверов WHOIS можно использовать флаг --custom-whois-server . Конечная точка сервера должна реализовать формат ответа HTTP, как определено в RFC 3912 , хотя также поддерживаются ответы в виде простого текста.

Функции

• Локальные DNS-запросы : выполнение DNS-поиска с использованием DNS-серверов, настроенных в ОС.

• Удаленный DNS-over-HTTPS : выполнение защищенных DNS-запросов через службы Cloudflare и Google DNS-over-HTTPS

• Поиск WHOIS : выполнение запросов WHOIS для получения информации о регистрации домена.

• Несколько типов записей : поддержка типов записей A, AAAA, CNAME, MX, NS, PTR, SOA, SRV и TXT.

• Механизм отката : автоматически пробует несколько DNS-серверов для получения надежных результатов.

• Поддержка SSE : запуск в качестве HTTP-сервера с Server-Sent Events (SSE) для веб-интеграции

Related MCP server: Google Toolbox

Установка

Конфигурация редактора

Добавьте следующую конфигурацию в настройки вашего редактора для использования mcp-domaintools :

{
  "mcpServers": {
    "dns": {
      "command": "mcp-domaintools",
      "args": [
        // Uncomment and modify as needed:
        // "--remote-server-address=https://your-custom-doh-server.com/dns-query",
        // "--custom-whois-server=whois.yourdomain.com",
        // "--timeout=10s"
      ],
      "env": {}
    }
  }
}

Вы можете использовать mcp-domaintools непосредственно из $PATH , как показано выше, или указать полный путь к двоичному файлу (например, /path/to/mcp-domaintools ).

Кроме того, вы можете запустить mcp-domaintools напрямую с Docker, не устанавливая двоичный файл:

{
  "mcpServers": {
    "dns": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/patrickdappollonio/mcp-domaintools:latest"
        // Add custom options if needed:
        // "--remote-server-address=https://your-custom-doh-server.com/dns-query",
        // "--custom-whois-server=whois.yourdomain.com",
        // "--timeout=10s"
      ],
      "env": {}
    }
  }
}

Информацию об инструментах, предоставляемых mcp-domaintools , см. в разделе «Доступные инструменты MCP» .

Homebrew (macOS и Linux)

brew install patrickdappollonio/tap/mcp-domaintools

Докер

Сервер MCP доступен в виде образа Docker, использующего stdio для связи:

docker pull ghcr.io/patrickdappollonio/mcp-domaintools:latest
docker run --rm ghcr.io/patrickdappollonio/mcp-domaintools:latest

Для режима SSE с Docker укажите порт SSE (по умолчанию 3000 ):

docker run --rm -p 3000:3000 ghcr.io/patrickdappollonio/mcp-domaintools:latest --sse --sse-port 3000

Ознакомьтесь с реализацией выше, чтобы узнать, как настроить сервер MCP для работы в качестве контейнера в вашем редакторе или инструменте.

Релизы GitHub

Загрузите готовые двоичные файлы для вашей платформы со страницы релизов GitHub .

Доступные инструменты MCP

Доступны 3 инструмента:

• local_dns_query : Выполнение DNS-запросов к локальному DNS-резолверу, настроенному ОС

• remote_dns_query : Выполнение DNS-запросов к удаленному серверу DNS-over-HTTPS

• whois_query : Выполнение поиска WHOIS для получения информации о регистрации домена

Режимы работы

Стандартный (stdio) режим

По умолчанию mcp-domaintools работает в режиме stdio, который подходит для интеграции с редакторами и другими инструментами, взаимодействующими через стандартный ввод/вывод.

mcp-domaintools

Режим событий, отправленных сервером (SSE)

В качестве альтернативы вы можете запустить mcp-domaintools как HTTP-сервер с поддержкой SSE для веб-интеграции:

mcp-domaintools --sse --sse-port=3000

В режиме SSE сервер будет прослушивать указанный порт (по умолчанию: 3000) и предоставлять те же инструменты MCP по HTTP с использованием Server-Sent Events. Это полезно для веб-приложений или сред, где stdio-коммуникация непрактична.

Доступные варианты SSE:

• --sse : Включить режим сервера SSE

• --sse-port=PORT : Укажите порт для прослушивания (по умолчанию: 3000)

Локальный DNS-запрос

Выполняет DNS-запросы, используя локальные DNS-серверы, определенные ОС.

Аргументы:

• domain (обязательно): доменное имя для запроса (например, example.com)

• record_type (обязательно): Тип записи DNS для запроса (A, AAAA, CNAME, MX, NS, PTR, SOA, SRV, TXT)

Удаленный DNS-запрос

Выполняет DNS-запросы, используя удаленные DNS-серверы через HTTPS (Google и Cloudflare).

Аргументы:

• domain (обязательно): доменное имя для запроса (например, example.com)

• record_type (обязательно): Тип записи DNS для запроса (A, AAAA, CNAME, MX, NS, PTR, SOA, SRV, TXT)

Запрос WHOIS

Выполняет поиск в WHOIS для получения информации о регистрации домена.

Аргументы:

• domain (обязательно): доменное имя для запроса (например, example.com)