Domain Tools (WHOIS + DNS)

DNS 및 WHOIS 쿼리 MCP 서버 mcp-domaintools

mcp-domaintools 는 AI 비서에 DNS 및 WHOIS 쿼리 기능을 제공하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. AI 모델이 로컬 DNS 확인자와 원격 DNS-over-HTTPS 서비스를 통해 DNS 조회를 수행할 수 있도록 지원합니다.

로컬 DNS 쿼리의 경우 시스템에 구성된 DNS 서버를 사용합니다. 원격 DNS 쿼리의 경우 Cloudflare DNS-over-HTTPS 쿼리를 사용하며, Google DNS-over-HTTPS로 대체합니다. 이는 대부분의 사용 사례에 충분합니다.

사용자 지정 DNS-over-HTTPS 서버의 경우 --remote-server-address 플래그를 사용할 수 있습니다. 서버 엔드포인트는 RFC 8484 에 정의된 HTTP 응답 형식을 구현해야 합니다.

사용자 지정 WHOIS 서버의 경우 --custom-whois-server 플래그를 사용할 수 있습니다. 서버 엔드포인트는 RFC 3912 에 정의된 HTTP 응답 형식을 구현해야 하지만, 일반 텍스트 응답도 지원됩니다.

특징

• 로컬 DNS 쿼리 : OS 구성 DNS 서버를 사용하여 DNS 조회를 수행합니다.
• 원격 DNS-over-HTTPS : Cloudflare 및 Google DNS-over-HTTPS 서비스를 통해 안전한 DNS 쿼리 수행
• WHOIS 조회 : 도메인 등록 정보를 얻기 위해 WHOIS 쿼리를 수행합니다.
• 다중 레코드 유형 : A, AAAA, CNAME, MX, NS, PTR, SOA, SRV 및 TXT 레코드 유형 지원
• 폴백 메커니즘 : 신뢰할 수 있는 결과를 위해 여러 DNS 서버를 자동으로 시도합니다.
• SSE 지원 : 웹 기반 통합을 위한 SSE(Server-Sent Events)를 사용하여 HTTP 서버로 실행

설치

편집기 구성

mcp-domaintools 사용하려면 편집기 설정에 다음 구성을 추가하세요.

지엑스피1

위에 표시된 대로 $PATH 에서 mcp-domaintools 직접 사용할 수도 있고 바이너리의 전체 경로를 제공할 수도 있습니다(예: /path/to/mcp-domaintools ).

또는 바이너리를 설치하지 않고 Docker에서 mcp-domaintools 직접 실행할 수 있습니다.

mcp-domaintools 에서 제공하는 도구에 대한 자세한 내용은 "사용 가능한 MCP 도구"를 참조하세요.

Homebrew(macOS 및 Linux)

도커

MCP 서버는 stdio 사용하여 통신하는 Docker 이미지로 제공됩니다.

Docker를 사용한 SSE 모드의 경우 SSE 포트(기본값 3000 )를 노출합니다.

편집기나 도구에서 컨테이너로 실행되도록 MCP 서버를 구성하는 방법은 위의 구현을 확인하세요.

GitHub 릴리스

GitHub 릴리스 페이지 에서 플랫폼에 맞는 사전 빌드된 바이너리를 다운로드하세요.

사용 가능한 MCP 도구

사용 가능한 도구는 3가지입니다.

• local_dns_query : OS에서 구성한 로컬 DNS 확인자에 대해 DNS 쿼리를 수행합니다.
• remote_dns_query : 원격 DNS-over-HTTPS 서버에 대한 DNS 쿼리를 수행합니다.
• whois_query : 도메인 등록 정보를 얻기 위해 WHOIS 조회를 수행합니다.

실행 모드

표준(stdio) 모드

기본적으로 mcp-domaintools stdio 모드에서 실행되며, 이는 표준 입출력을 통해 통신하는 편집기 및 기타 도구와의 통합에 적합합니다.

서버 전송 이벤트(SSE) 모드

또는 웹 기반 통합을 위한 SSE 지원과 함께 HTTP 서버로 mcp-domaintools 실행할 수 있습니다.

SSE 모드에서 서버는 지정된 포트(기본값: 3000)에서 수신 대기하고, 서버 전송 이벤트(Server-Sent Events)를 사용하여 HTTP를 통해 동일한 MCP 도구를 제공합니다. 이 기능은 웹 애플리케이션이나 stdio 통신이 어려운 환경에 유용합니다.

사용 가능한 SSE 옵션:

• --sse : SSE 서버 모드 활성화
• --sse-port=PORT : 수신할 포트를 지정합니다(기본값: 3000)

로컬 DNS 쿼리

로컬 OS에서 정의한 DNS 서버를 사용하여 DNS 쿼리를 수행합니다.

인수:

• domain (필수): 쿼리할 도메인 이름(예: example.com)
• record_type (필수): 쿼리할 DNS 레코드 유형(A, AAAA, CNAME, MX, NS, PTR, SOA, SRV, TXT)

원격 DNS 쿼리

원격 DNS-over-HTTPS 서버(Google 및 Cloudflare)를 사용하여 DNS 쿼리를 수행합니다.

인수:

• domain (필수): 쿼리할 도메인 이름(예: example.com)
• record_type (필수): 쿼리할 DNS 레코드 유형(A, AAAA, CNAME, MX, NS, PTR, SOA, SRV, TXT)

WHOIS 쿼리

WHOIS 조회를 수행하여 도메인 등록 정보를 얻습니다.

인수:

• domain (필수): 쿼리할 도메인 이름(예: example.com)