Whodis MCP Server

Whodis MCP 서버

이 프로젝트는 WHOIS 조회를 사용하여 도메인 이름의 가용성을 확인하도록 특별히 설계된 모델 컨텍스트 프로토콜(MCP) 서버를 제공합니다. 이를 통해 AI 어시스턴트 또는 기타 도구가 도메인 가용성 확인을 워크플로에 통합할 수 있습니다.

개요

MCP란 무엇인가요?

모델 컨텍스트 프로토콜(MCP)은 AI 시스템이 외부 도구 및 데이터 소스와 안전하고 상황에 맞게 연결할 수 있도록 하는 개방형 표준입니다. 이 서버는 도메인 가용성 정보를 제공하기 위해 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 검사기에 액세스하여 도구를 테스트하고 요청/응답 세부 정보를 확인하세요.

1. npm run dev:server
2. 브라우저에서 http://localhost:5173을 엽니다.
3. UI를 사용하여 check-domain-availability 도구를 호출합니다.

서버 로그

자세한 출력을 위해 디버그 로그를 활성화하세요.

로그는 ~/.mcp/data/whodis-mcp-server.*.log 에도 저장됩니다.

출판

npm에 업데이트를 게시하려면:

1. 변경 사항이 커밋되었는지 확인하고 기존 커밋 메시지(예: feat: , fix: , chore: )를 따릅니다.
2. 변경 사항을 main 브랜치에 푸시합니다.
3. ci-semantic-release.yml 워크플로는 패키지를 자동으로 빌드하고, 테스트하고, 버전을 관리하고, npm에 게시합니다.

특허

ISC 라이센스