Mail Viewer MCP 서버: AI 기반 이메일 변환 및 검사

CoolUtils Mail Viewer에는 내장형 MCP(Model Context Protocol) 서버가 포함되어 있습니다. MailViewer.exe --mcp를 실행하면 프로그램이 GUI를 건너뛰고 AI 어시스턴트가 직접 호출할 수 있는 백그라운드 서버로 작동합니다. Claude Code, Claude Desktop, Cursor, Cline 및 MCP 호환 에이전트는 별도의 스크립트 작성 없이 일반 언어 지시만으로 이메일 파일을 변환하고, 읽고, 첨부 파일을 추출할 수 있습니다.

MCP란 무엇인가?

Model Context Protocol은 Anthropic이 공개한 오픈 표준으로, AI 에이전트가 데스크톱 소프트웨어를 원격 API처럼 호출할 수 있게 해줍니다. 스크립트를 작성하거나 명령줄을 사용하는 대신, 필요한 내용을 자연어로 설명하면 됩니다. 에이전트가 매개변수를 결정하고 올바른 도구를 호출합니다 — 이 경우 백그라운드에서 자동으로 실행되는 Mail Viewer를 호출합니다.

MCP 서버는 일반 MailViewer.exe 바이너리 안에 내장되어 있습니다. 별도로 설치하거나 라이선스를 구매할 필요가 없습니다. --mcp 플래그는 시작 동작만 변경합니다: GUI가 숨겨지고 백그라운드 stdio 리더 스레드가 시작됩니다.

할 수 있는 작업

연결되면 AI 어시스턴트에게 다음과 같은 지시를 내릴 수 있습니다:

세 가지 사용 가능한 도구

convert_mail

메일 파일을 지정된 출력 형식으로 변환합니다. Mail Viewer의 완전한 렌더링 엔진을 사용하므로 PDF 및 DOCX 출력에는 내장 HTML, 인라인 이미지, 첨부 파일 미리보기, 메시지 헤더가 포함됩니다 — GUI에서 보이는 것과 동일합니다.

소스 형식: .eml, .msg, .mim, .p7m, .vmbx, .tnef, .mapixml, .olk15, .vcf, .contact, .3uc
출력 형식: pdf, html, txt, doc, rtf, tiff, jpg, png, bmp, emf, eml, xps

get_mail_info

메일 파일을 읽고 메타데이터를 JSON으로 반환합니다: 발신자, 수신자/참조/숨은 참조, 제목, 날짜, 원시 RFC 헤더, 일반 텍스트 및 HTML 본문, 이름·크기·콘텐츠 유형을 포함한 첨부 파일 목록. 소스 파일은 수정되지 않습니다.

extract_attachments

메일 파일의 모든 첨부 파일을 대상 폴더에 저장합니다(폴더가 없으면 자동으로 생성됩니다). 저장된 파일 목록을 절대 경로와 바이트 단위 크기와 함께 반환합니다.

Claude Code에 연결하기

~/.claude.json 파일의 mcpServers 객체 안에 다음 블록을 추가하세요(키가 없으면 새로 만드세요):

{
  "mcpServers": {
    "mailviewer": {
      "command": "C:\\Program Files\\CoolUtils\\CoolUtils Mail Viewer\\MailViewer.exe",
      "args": ["--mcp"]
    }
  }
}

복사 즉시 사용 가능한 스니펫이 실행 파일 옆에 claude-config-snippet.json으로 설치됩니다. Mail Viewer를 기본이 아닌 위치에 설치했다면 경로를 수정하세요.

Claude Desktop에 연결하기

%APPDATA%\Claude\claude_desktop_config.json을 열고 mcpServers 아래에 동일한 블록을 추가하세요:

{
  "mcpServers": {
    "mailviewer": {
      "command": "C:\\Program Files\\CoolUtils\\CoolUtils Mail Viewer\\MailViewer.exe",
      "args": ["--mcp"]
    }
  }
}

동일한 설정 형식이 Cursor, Cline 및 Model Context Protocol 표준을 지원하는 모든 에이전트에서 작동합니다.

설치 확인

명령 프롬프트에서 다음을 실행하여 MCP 서버가 올바르게 응답하는지 확인하세요:

echo {"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"t","version":"0"}}} | "C:\Program Files\CoolUtils\CoolUtils Mail Viewer\MailViewer.exe" --mcp

protocolVersion, serverInfo, tools 기능이 포함된 단일 JSON-RPC 응답이 표시되어야 합니다. 이 응답이 나타나면 서버를 사용할 준비가 된 것입니다.

기술 세부 정보

개발자 및 통합 담당자를 위한 참고 사항: 서버는 NDJSON(한 줄에 하나의 JSON-RPC 2.0 메시지, UTF-8 인코딩)을 사용하여 stdio로 통신합니다. 프로토콜 버전: 2024-11-05. initialize에서 보고되는 서버 이름: mailviewer-mcp. 세 가지 도구의 전체 입력 스키마는 실행 파일 옆에 mcp-tools.json으로 설치됩니다. 기계 판독 가능한 서버 매니페스트는 mcp-server.json으로 제공됩니다.