MailboxValidator MCP 서버

이것은 MailboxValidator API를 위한 간단한 MCP(Model Context Protocol) 서버 구현입니다. 이메일 주소에 대한 검증 결과를 반환합니다.

기능

• 포괄적인 이메일 검증: 구문, DNS, MX 서버, 고위험군, 수신 거부 목록 등을 확인하여 이메일 주소에 도달 가능한지 확인합니다.

• 일회용 이메일: 이메일 주소가 임시/일회용 이메일 제공업체에서 생성된 것인지 확인합니다.

• 무료 이메일: 이메일 주소가 무료 이메일 제공업체에서 생성된 것인지 확인합니다.

요구 사항

이 MCP 서버는 API 키가 필요합니다. 여기에서 무료 API 키를 신청하여 매월 최대 300개의 쿼리를 사용할 수 있습니다.

또한 이 설정은 Node.js와 npm을 사용하며, Node.js 웹사이트에서 다운로드할 수 있습니다.

설정

Claude Desktop에서 이 MCP 서버를 사용하려면 다음 단계를 따르세요:

1. 저장소를 로컬로 다운로드합니다.

2. 프로젝트 폴더 내에서 다음 명령어를 실행하여 종속성을 설치하고 서버를 빌드합니다.

npm install
npm run build

3. Claude Desktop이 설치되어 있는지 확인하세요. 설치되어 있지 않다면 Windows 및 MacOS 사용자는 여기에서 다운로드하고, Linux 사용자는 이 가이드를 따르세요.

4. 원하는 편집기에서 claude_desktop_config.json을 엽니다. 아직 파일이 없다면 이 가이드를 따라 생성하세요.

5. claude_desktop_config.json에 다음 내용을 추가합니다:

{
  "mcpServers": {
    "mailboxvalidator": {
      "command": "node",
      "args": [
        "C:\\path\\to\\mcp-mailboxvalidator\\build\\index.js"
      ],
      "env": {
        "MAILBOXVALIDATOR_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

6. index.js의 경로를 로컬 컴퓨터에 있는 MailboxValidator MCP 서버의 실제 경로로 바꾸는 것을 잊지 마세요.

7. API 키를 얻으려면 대시보드에 로그인하여 확인하세요. 위 내용의 <YOUR_API_KEY>를 실제 API 키로 교체하세요.

8. 변경 사항을 저장한 후 Claude Desktop을 다시 시작하면 Search and tools 메뉴에 나타날 것입니다.

사용법

Claude Desktop 채팅창에 이메일 주소에 대한 질문을 입력하세요. 예시 질문은 다음과 같습니다:

• (email)은 유효한 이메일 주소인가요?

• (email)은 가짜 이메일인가요?

• (email)은 무료 이메일인가요?

Claude Desktop에서 모델은 MailboxValidator MCP 서버가 반환한 결과를 바탕으로 자동으로 답변을 생성합니다.

환경 변수

MAILBOXVALIDATOR_API_KEY

무료 MailboxValidator API 키를 사용하면 매월 최대 300개의 이메일을 쿼리할 수 있습니다. 더 많은 쿼리가 필요하면 유료 API 플랜을 신청하세요.

도구

validate_email

설명 제공된 이메일 주소를 검증합니다. 구문, DNS, MX 서버, 일회용 목록 등을 확인하여 이메일 주소에 도달 가능한지 판단하도록 돕습니다.

인자 email (str): 검증할 이메일 주소.

반환값 검증 데이터가 포함된 JSON 문자열. 결과에는 다음 필드가 포함됩니다:

• Syntax: 이메일 주소가 올바른 형식인지 확인합니다.

• DNS & MX Server: 도메인 DNS에 MX 서버가 지정되어 있는지 확인합니다.

• Network & Connectivity: MX 서버에 연결을 시도하여 작동 여부를 확인합니다.

• Greylisting: MX 서버가 그레이리스팅을 사용하여 이메일 반송을 유발할 수 있는지 확인합니다.

• Disposable List: 이메일 도메인이 임시 또는 일회용 이메일 제공업체인지 확인합니다.

• High Risk & Suppressed List: 이메일 사용자 이름이 고위험군으로 보이는지 또는 수신 거부 목록에 있는지 확인합니다.

• Others: 이메일 평판 점수 등을 확인합니다.

요청이 실패하면 도구는 오류 메시지를 문자열로 반환합니다.

check_disposable_email

설명 제공된 이메일 주소가 일회용 이메일 제공업체에서 생성되었는지 확인합니다.

인자 email (str): 확인할 이메일 주소.

반환값 일회용 이메일 데이터가 포함된 JSON 문자열. 결과에는 다음 필드가 포함됩니다:

• Disposable List: 이메일 도메인이 임시 또는 일회용 이메일 제공업체인지 확인합니다.

요청이 실패하면 도구는 오류 메시지를 문자열로 반환합니다.

check_free_email

설명 제공된 이메일 주소가 무료 이메일 제공업체에서 생성되었는지 확인합니다.

인자 email (str): 확인할 이메일 주소.

반환값 무료 이메일 데이터가 포함된 JSON 문자열. 결과에는 다음 필드가 포함됩니다:

• Free Email List: 이메일 도메인이 무료 이메일 제공업체인지 확인합니다.

요청이 실패하면 도구는 오류 메시지를 문자열로 반환합니다.

라이선스

LICENSE 파일을 참조하세요.