Markdownify는 다양한 파일 형식과 웹 콘텐츠를 Markdown 형식으로 변환하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. PDF, 이미지, 오디오 파일, 웹 페이지 등을 읽고 공유하기 쉬운 Markdown 텍스트로 변환하는 도구 세트를 제공합니다.

프로젝트 개요

Markdownify MCP Server는 Zach Caceres (GitHub: zcaceres)가 개발한 Model Context Protocol (MCP) 서버로, 다양한 파일 형식과 웹 페이지 콘텐츠를 Markdown 형식으로 변환하는 것을 목표로 합니다.

• 주요 용도: AI 에이전트 또는 데스크톱 도구에 통합된 Markdown 변환 서비스 제공.
• 지원 환경: TypeScript + Node.js 기반으로, Python 도구 컴포넌트와 함께 실행됩니다.

---

핵심 기능 / 특징

✅ 다양한 파일 형식을 Markdown으로 변환

유형	지원 도구
문서	PDF, DOCX, XLSX, PPTX를 Markdown으로 변환
미디어	이미지 (메타데이터 포함), 오디오 (전사 텍스트 포함)
웹 콘텐츠	일반 웹 페이지, YouTube 비디오, Bing 검색 결과

전체 도구 목록은 다음과 같습니다 (README에서 발췌):

• pdf-to-markdown
• docx-to-markdown
• xlsx-to-markdown
• pptx-to-markdown
• image-to-markdown
• audio-to-markdown
• webpage-to-markdown
• youtube-to-markdown
• bing-search-to-markdown
• get-markdown-file: 기존 .md 또는 .markdown 파일 검색 허용

🔧 환경 설정 및 사용 방법

1. 저장소 복제
2. 의존성 설치: pnpm install (uv/python 의존성도 함께 설치)
3. 빌드: pnpm run build
4. 서비스 시작: pnpm start

pnpm run dev를 통해 TS watch 모드를 시작하고 src/server.ts 또는 src/tools.ts를 수정하여 동작을 사용자 정의할 수 있습니다. 데스크톱 클라이언트 (예: Cursor)에 통합하여 구성 JSON에서 해당 MCP 서비스를 선언할 수도 있습니다.

⚙️ 선택적 구성

• 환경 변수 MD_SHARE_DIR을 통해 Markdown 파일 읽기를 허용하는 디렉토리를 제한하여 접근 제어를 강화할 수 있습니다 ([github.com][1]).

요약 및 제안

• 장점

  • 다양한 파일 형식 지원, 포괄적인 기능
  • 간편한 통합, 조합 가능한 배포
  • 활발한 커뮤니티, 상세한 문서, 쉬운 사용법

• 단점 / 주의 사항

  • 현재 중간 수준의 보안 위험이 존재하므로, 안전하게 격리된 환경에서만 사용하거나 공식 패치를 기다리는 것이 좋습니다.
  • Windows 지원은 아직 개선이 필요합니다 (프로젝트 작성자는 Windows PR 테스트에 도움을 줄 사람을 찾고 있습니다).

• 적용 시나리오

  • AI 어시스턴트, 자동화 스크립트에서 통합된 Markdown 입력/출력이 필요한 경우
  • 콘텐츠 수집, 문서 보관, 연구 자료 정리 등의 시나리오
  • 다양한 형식에서 Markdown으로의 빠른 통합 서비스를 원하는 웹 또는 데스크톱 프로젝트