Repolode
zcaceres

zcaceres/markdownify-mcp

PDF, 이미지, 오디오, Office 파일, YouTube 자막 및 웹 페이지를 AI 어시스턴트용 Markdown으로 변환하는 MCP 서버입니다.

스타
2,997
포크
255
열린 이슈
31
마지막 커밋
26일 전

어떤 프로젝트인가요?

Markdownify는 AI 어시스턴트가 파일과 웹 콘텐츠를 Markdown 텍스트로 변환할 수 있도록 도구를 제공하는 Model Context Protocol 서버입니다. PDF, 이미지, 오디오(음성 전사 포함), DOCX, XLSX, PPTX 파일뿐 아니라 YouTube 동영상 자막, Bing 검색 결과, 일반 웹 페이지도 처리합니다. 기존 Markdown 파일을 읽을 수도 있습니다.

이 서버는 TypeScript로 작성되었으며 Bun 또는 Node에서 실행됩니다. 파일 변환은 Python markitdown 설치본에 위임하고, 사전 설치 단계에서 로컬 가상 환경을 구성합니다. 각 변환 기능은 pdf-to-markdown이나 webpage-to-markdown처럼 이름이 지정된 도구로 제공되며, MCP 클라이언트가 호출할 수 있습니다.

MD_ALLOWED_PATHS 환경 변수를 사용하면 로컬 파일 접근을 제한하고 파일 입력 도구가 사용할 수 있는 디렉터리 목록을 지정할 수 있습니다. Dockerfile도 포함되어 있지만, slim 이미지는 오디오 및 OCR 지원을 제외합니다.

핵심 기능

  • 01PDF, DOCX, XLSX, PPTX 파일을 Markdown으로 변환
  • 02오디오 파일을 전사하고 이미지에서 텍스트 추출
  • 03YouTube 자막, Bing 검색 결과, 웹 페이지를 가져와 Markdown으로 변환
  • 04각 변환 기능을 별도의 MCP 도구로 제공
  • 05MD_ALLOWED_PATHS를 통해 허용된 디렉터리로 파일 접근 제한

활용 사례

  • AI 어시스턴트에 PDF나 Office 문서의 내용을 텍스트로 제공
  • 자막을 바탕으로 YouTube 동영상 요약
  • 웹 페이지나 검색 결과를 깔끔한 Markdown으로 LLM에 전달
  • 회의 녹음 파일을 검색 가능한 전사문으로 변환

빠른 시작

  1. 1

    이 리포지토리를 클론합니다

  2. 2

    종속성을 설치합니다(markitdown이 포함된 Python 가상 환경도 생성됩니다)

    bun install
  3. 3

    프로젝트를 빌드합니다

    bun run build
  4. 4

    서버를 시작합니다

    bun start

사용 전 알아둘 점

  • 설정하려면 markitdown 종속성을 설치할 Bun과 Python이 필요합니다.
  • 게시된 Docker 이미지에는 오디오 전사 및 이미지 OCR 기능이 없습니다.

토픽

자주 묻는 질문

markdownify-mcp은(는) 무엇인가요?
PDF, 이미지, 오디오, Office 파일, YouTube 자막 및 웹 페이지를 AI 어시스턴트용 Markdown으로 변환하는 MCP 서버입니다. Markdownify는 AI 어시스턴트가 파일과 웹 콘텐츠를 Markdown 텍스트로 변환할 수 있도록 도구를 제공하는 Model Context Protocol 서버입니다. PDF, 이미지, 오디오(음성 전사 포함), DOCX, XLSX, PPTX 파일뿐 아니라 YouTube 동영상 자막, Bing 검색 결과, 일반 웹 페이지도 처리합니다. 기존 Markdown 파일을 읽을 수도 있습니다.
markdownify-mcp은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
markdownify-mcp은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
markdownify-mcp은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. markdownify-mcp의 마지막 커밋은 2026년 9월 25일입니다.
markdownify-mcp은(는) 어디에 사용할 수 있나요?
AI 어시스턴트에 PDF나 Office 문서의 내용을 텍스트로 제공 자막을 바탕으로 YouTube 동영상 요약 웹 페이지나 검색 결과를 깔끔한 Markdown으로 LLM에 전달 회의 녹음 파일을 검색 가능한 전사문으로 변환
markdownify-mcp는 어떻게 설치하나요?
이 리포지토리를 클론합니다 종속성을 설치합니다(markitdown이 포함된 Python 가상 환경도 생성됩니다): bun install 프로젝트를 빌드합니다: bun run build 서버를 시작합니다: bun start
markdownify-mcp은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/zcaceres/markdownify-mcp

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트