Whodis MCP 서버
이 프로젝트는 WHOIS 조회를 사용하여 도메인 이름의 가용성을 확인하도록 특별히 설계된 모델 컨텍스트 프로토콜(MCP) 서버를 제공합니다. 이를 통해 AI 어시스턴트 또는 기타 도구가 도메인 가용성 확인을 워크플로에 통합할 수 있습니다.
개요
MCP란 무엇인가요?
모델 컨텍스트 프로토콜(MCP)은 AI 시스템이 외부 도구 및 데이터 소스와 안전하고 상황에 맞게 연결할 수 있도록 하는 개방형 표준입니다. 이 서버는 도메인 가용성 정보를 제공하기 위해 MCP 표준을 구현합니다.
Related MCP server: WebSearch-MCP
특징
도메인 가용성 확인 :
whoiser라이브러리를 사용하여 WHOIS 조회를 수행하고 도메인이 사용 가능하거나 등록된 것으로 보이는지 확인합니다.MCP 도구 통합 : MCP 클라이언트(AI 어시스턴트 등)를 위한
check-domain-availability도구를 제공합니다.CLI 인터페이스 : 직접 사용 및 테스트를 위한 명령줄 인터페이스(
whodis-mcp-server check-domain-availability ...)가 포함되어 있습니다.구조화된 로깅 : 디버깅 및 모니터링을 위한 자세한 로깅을 제공합니다.
구성 가능 : 환경 변수나
.env파일을 통한 구성을 지원합니다.
시작하기
필수 조건
Node.js (>=18.x): 다운로드
Git : 버전 제어를 위해
1단계: 복제 및 설치
지엑스피1
2단계: 개발 서버 실행
MCP 검사기를 통해 서버와 상호 작용하려면 개발 모드에서 서버를 시작하세요.
이렇게 하면 MCP 서버가 시작되고 http://localhost:5173 에서 MCP 검사기가 활성화되어 check-domain-availability 도구를 테스트할 수 있습니다.
3단계: CLI를 통해 도구 테스트
명령줄에서 직접 도메인 가용성 검사기를 실행합니다.
CLI는 available 과 unavailable 배열을 포함하는 JSON 객체를 출력합니다.
건축학
이 서버는 계층화된 아키텍처를 따릅니다.
개발 가이드
개발 스크립트
테스트
코드 품질
MCP 도구: check-domain-availability
목적 : 하나 이상의 도메인 이름의 가용성을 확인합니다.
입력 : 도메인 이름의 배열.
{ "domains": ["example.com", "another-domain.net"] }출력 :
available(등록되지 않은 것으로 보이는 도메인)과unavailable(등록된 것으로 보이는 도메인)의 두 배열을 포함하는 JSON 객체입니다.{ "available": ["likely-available-domain123.xyz"], "unavailable": ["google.com"] }참고 : 가용성 확인은 WHOIS 서버 응답에 따라 달라지며, 모든 TLD에 대해 100% 정확하지 않거나 일시적인 네트워크 문제로 인해 정확하지 않을 수 있습니다. 조회에 실패한 도메인은 제외됩니다.
사용 시기 : 특정 도메인 이름을 잠재적으로 등록할 수 있는지 확인해야 할 때 이 도구를 사용하세요.
디버깅
MCP 검사관
시각적 MCP 검사기에 액세스하여 도구를 테스트하고 요청/응답 세부 정보를 확인하세요.
npm run dev:server브라우저에서 http://localhost:5173을 엽니다.
UI를 사용하여
check-domain-availability도구를 호출합니다.
서버 로그
자세한 출력을 위해 디버그 로그를 활성화하세요.
로그는 ~/.mcp/data/whodis-mcp-server.*.log 에도 저장됩니다.
출판
npm에 업데이트를 게시하려면:
변경 사항이 커밋되었는지 확인하고 기존 커밋 메시지(예:
feat:,fix:,chore:)를 따릅니다.변경 사항을
main브랜치에 푸시합니다.ci-semantic-release.yml워크플로는 패키지를 자동으로 빌드하고, 테스트하고, 버전을 관리하고, npm에 게시합니다.