MarkItDown MCP의 개요
MarkItDown은 파일과 오피스 문서를 Markdown으로 변환하는 Microsoft의 Python 도구이며, 본 저장소의 GitHub 스타는 약 191,700개입니다. markitdown-mcp 패키지는 이를 MCP 서버로 감싼 것으로, AutoGen 팀이 만들었습니다.
도구는 convert_to_markdown(uri) 단 하나이며, http:, https:, file:, data: URI를 받습니다. 기본적으로 stdio로 실행되고, --http 플래그를 주면 Streamable HTTP와 SSE로 실행되며 localhost에 바인딩합니다. pip install markitdown-mcp로 설치합니다. Claude Desktop용으로 README는 저장소의 Dockerfile로 Docker 이미지를 빌드하고 로컬 파일용 폴더 하나를 마운트하라고 권합니다. 공식 MCP 레지스트리에는 올라 있지 않습니다.
패키지는 아직 알파 버전입니다. 2025년 3월 첫 알파가 나온 뒤, 2026년 10월 21일 MarkItDown 0.1.9와 함께 0.0.1a8이 나왔습니다.
MarkItDown MCP 설치 방법
pip install markitdown-mcpMarkItDown MCP, 쓸 만한 가치가 있습니까?
MarkItDown MCP는 로컬 에이전트가 Office 파일과 PDF를 읽게 하는 방법 중 컨텍스트로도 비용으로도 가장 저렴하며, 보안 모델은 결국 기기의 모든 것을 신뢰하는 것입니다. 도구가 하나뿐이라 컨텍스트 부담이 거의 없고, 같은 호출로 로컬 파일, URL, 인라인 데이터를 모두 처리합니다.
지원 형식은 넓습니다. PDF, Word, PowerPoint, Excel, EPub, HTML, CSV, JSON, XML에 더해, 이미지는 EXIF 메타데이터와 OCR로, 오디오는 음성 전사로 처리하고, ZIP 압축 파일과 YouTube URL도 다룹니다. MCP 패키지는 markitdown[all]을 고정해 두므로, 필요 여부와 상관없이 모든 선택 변환기가 설치됩니다. Windows ARM64에서 설치가 실패한다는 열린 issue의 원인이 이것입니다.
README의 보안 절은 드물 만큼 직설적입니다. 인증이 없고, 서버는 사용자의 권한으로 실행되며, convert_to_markdown은 그 사용자가 읽을 수 있는 어떤 파일이든 읽고 네트워크의 무엇이든 가져올 수 있습니다. 여기에 신뢰할 수 없는 문서를 읽는 에이전트를 더하면, 프롬프트 인젝션으로 file:///home/you/.ssh/config를 변환하라는 지시가 들어오는 일은 충분히 있을 법한 실패입니다. 폴더 하나만 마운트한 Docker 방식이 합리적인 기본값이지만, 이미지는 직접 빌드해야 합니다. 공식 이미지는 공개되어 있지 않습니다.
경쟁 도구보다 못한 부분은 변환 이후의 모든 것입니다. 검색, 청크 분할, 페이지 선택이 없으므로 300쪽짜리 PDF가 한 덩어리로 컨텍스트에 들어가며, 출력은 충실한 레이아웃보다 텍스트 구조를 목표로 합니다. 19개월 동안 알파를 8번 냈는데도 패키지 버전은 여전히 0.0.1이고, 열린 issue 하나는 VS Code의 MCP 갤러리가 아직도 0.0.1a4를 설치한다고 지적합니다.
제 역할을 하는 곳
Claude Desktop을 쓰는 30인 규모 회사의 재무 분석가
분기별 Excel과 PowerPoint 자료를 웹 앱에 올리지 않고 요약하기
Docker 이미지를 빌드하고 보고서 폴더만 /workdir에 마운트한 뒤, Claude Desktop이 docker run을 가리키게 합니다. 변환은 무료이고 로컬에서 이루어집니다. 비용은 모델 토큰이며, 통합 문서가 통째로 들어가기 때문입니다.
Claude Agent SDK로 문서 수집 에이전트를 만드는 AI 엔지니어
청크로 나누기 전에 고객이 올린 여러 형식의 파일을 Markdown으로 바꾸기
컨테이너 안에서 127.0.0.1:3001로 markitdown-mcp --http를 실행하고 업로드 파일을 data: URI로 넘기면, 서버에 파일 시스템 접근이 전혀 필요 없습니다. 청크 분할과 페이지 선택은 직접 작성한 코드에 두어야 합니다.
개발자 노트북용 MCP 서버를 승인하는 보안 엔지니어
MarkItDown 설치를 허용할지 정하기
디렉터리 하나만 마운트하고 localhost 외의 주소에 바인딩하지 않는 Docker 구성만 허용하십시오. 그냥 pip install로 설치하면 사용자의 파일 접근 권한 전체로 실행되므로, 주입된 지시가 담긴 문서 하나로 에이전트가 프로젝트 밖의 파일을 읽을 수 있습니다.
도입 전 확인할 점
- 설정
- pip install markitdown-mcp(Python 3.10+)로 설치하고, stdio는 markitdown-mcp로, Streamable HTTP와 SSE는 markitdown-mcp --http --host 127.0.0.1 --port 3001로 실행합니다. Claude Desktop에서는 Dockerfile로 이미지를 빌드해 docker run으로 실행합니다. 첫 호출까지 몇 분이면 됩니다.
- 연동
- 도구는 convert_to_markdown(uri) 하나이며 http:, https:, file:, data: URI를 받습니다. 아무것도 쓰지 않지만, 프로세스가 닿을 수 있는 것은 무엇이든 읽을 수 있습니다. 문서화된 디버깅 방법은 MCP Inspector입니다.
- 데이터와 개인정보
- 계정 없이 로컬에서 실행되며 Microsoft로는 아무것도 보내지 않습니다. 인증이 없으며, HTTP 모드에서는 어떤 로컬 프로세스나 사용자든 호출할 수 있습니다. 가져온 페이지와 문서는 모델 컨텍스트 안의 신뢰할 수 없는 텍스트입니다.
- 대규모 사용 시 비용
- MIT로 무료이며 비용은 모델 토큰입니다. 도구에 페이지나 크기 파라미터가 없으므로, 긴 PDF 하나가 호출 한 번에 컨텍스트 창의 큰 부분을 차지할 수 있습니다.
- 제한
- 페이지 나눔, 청크 분할, 검색이 없고 레이아웃은 텍스트 구조로 평탄화됩니다. 열린 issue에는 필수 의존성인 markitdown[all] 때문에 Windows ARM64에서 설치가 실패하는 문제와, VS Code 갤러리가 예전 버전인 0.0.1a4를 설치하는 문제가 있습니다.
좋은 점
- 도구가 하나뿐이라 컨텍스트 부담이 거의 없습니다
- PDF, Office, EPub, HTML, 이미지, 오디오, ZIP을 변환합니다
- file, http(s), data URI를 받습니다
- MIT 라이선스이며 격리용 Dockerfile이 있습니다
아쉬운 점
- 인증이 없고 사용자가 읽을 수 있는 모든 파일을 읽습니다
- 문서 전체가 페이지 나눔 없이 컨텍스트에 들어갑니다
- 공개된 Docker 이미지가 없어 직접 빌드해야 합니다
- 아직 0.0.1a8 알파 버전입니다
추천 대상
에이전트가 PDF와 Office 문서를 어디에도 올리지 않고 로컬에서 읽게 하고 싶은 개발자입니다.
MarkItDown MCP 대안
MarkItDown MCP: 자주 묻는 질문
- MarkItDown MCP, 쓸 만한 가치가 있습니까?
- 제 몫을 하는 도구 하나짜리 문서 변환기입니다. 단, 의도한 파일만 볼 수 있는 컨테이너 안에서 실행할 때에 한합니다. 평점은 5점 만점에 3.9점입니다.
- MarkItDown MCP의 가격은 얼마입니까?
- 무료 오픈소스입니다(MIT).
- MarkItDown MCP의 단점은 무엇입니까?
- 인증이 없고 사용자가 읽을 수 있는 모든 파일을 읽습니다; 문서 전체 가 페이지 나눔 없이 컨텍스트에 들어갑니다; 공개된 Docker 이미지가 없어 직접 빌드해야 합니다; 아직 0.0.1a8 알파 버전입니다.
- MarkItDown MCP에 적합한 사람은 누구입니까?
- 에이전트가 PDF와 Office 문서를 어디에도 올리지 않고 로컬에서 읽게 하고 싶은 개발자입니다.
- 팀이나 프로덕션 환경에서 MarkItDown MCP의 비용은 얼마입니까?
- MIT로 무료이며 비용은 모델 토큰입니다. 도구에 페이지나 크기 파라미터가 없으므로, 긴 PDF 하나가 호출 한 번에 컨텍스트 창의 큰 부분을 차지할 수 있습니다.
- MarkItDown MCP에 회사 데이터를 맡겨도 안전합니까?
- 계정 없이 로컬에서 실행되며 Microsoft로는 아무것도 보내지 않습니다. 인증이 없으며, HTTP 모드에서는 어떤 로컬 프로세스나 사용자든 호출할 수 있습니다. 가져온 페이지와 문서는 모델 컨텍스트 안의 신뢰할 수 없는 텍스트입니다.
- MarkItDown MCP의 가장 좋은 대안은 무엇입니까?
- 저희가 리뷰한 것 중 가장 가까운 대안은 Fetch (reference server), Filesystem (reference server) 및 Firecrawl MCP입니다.
답변 확인일: 2026년 10월 23일.