M365 Attachment Reader MCP

Microsoft Graph API를 통해 Outlook 이메일을 읽고 이메일 첨부 파일을 심층적으로 분석하는 Claude용 원격 MCP 서버입니다.

현재 지원되는 첨부 파일 처리 형식은 PDF, OCR이 포함된 스캔 PDF, Word, PowerPoint, Excel, CSV, 일반 텍스트, 이미지, 아카이브 및 Outlook .msg 파일입니다.

상태: 초기 Windows 기반 테스트 버전입니다. 개인적인 용도와 비공개 워크플로우에는 기능하지만, 아직 프로덕션용 다중 사용자 서비스는 아닙니다.

이 프로젝트의 목적

Claude의 내장 Microsoft 365 커넥터는 이메일 목록을 나열하고, 메시지 본문을 읽고, 일정을 확인할 수 있습니다. 하지만 이메일 첨부 파일 내부의 실제 콘텐츠는 읽을 수 없습니다.

즉, "최근 이메일에 있는 PDF 내용이 뭐야?"라고 물어보면 Claude는 첨부 파일 메타데이터는 볼 수 있지만, 그 안에 있는 텍스트, 표, 이미지 또는 중첩된 문서는 볼 수 없습니다.

이 프로젝트는 그 간극을 메워줍니다.

주요 기능

이 서버는 Claude와 Microsoft 365 사이에서 원격 HTTP MCP 엔드포인트 역할을 합니다. 다음과 같은 기능을 수행합니다:

1. 장치 코드 흐름(device code flow)을 통해 Microsoft 365 인증

2. Microsoft Graph를 통해 Outlook 이메일 및 첨부 파일 목록 조회

3. 백엔드에서 첨부 파일 다운로드

4. 파일 콘텐츠를 파싱하여 구조화된 텍스트 및 이미지 블록을 Claude에 직접 반환

지원 형식

이미지 처리는 핵심 차별화 요소입니다. 서버는 독립형 이미지 첨부 파일을 MCP 이미지 블록으로 반환하고, DOCX 및 PPTX 파일에서 포함된 이미지를 추출하며, 텍스트 레이어가 없는 스캔 PDF의 경우 OCR을 수행합니다.

MCP 도구