본문으로 건너뛰기
MCP 서버 전체 목록

Markdownify MCP

  • 추천0
  • GitHub 별3K
  • 문서라이선스MIT

PDF · 이미지 · 오디오 · DOCX · XLSX · PPTX · 웹 페이지 · YouTube 자막을 Markdown으로 바꿔 주는 MCP 서버. MIT

원본:zcaceres/markdownify-mcp

설치 방법은 설치 탭에 정리했어요.

설명

Markdownify MCP 서버

markdownify mcp 로고

Markdownify는 여러 파일 형식과 웹 콘텐츠를 Markdown으로 바꿔 주는 Model Context Protocol(MCP) 서버입니다. PDF, 이미지, 오디오 파일, 웹 페이지 등을 읽고 공유하기 쉬운 Markdown 텍스트로 바꾸는 도구 모음을 제공합니다.

Markdownify 서버 MCP 서버

기능

  • 여러 파일 형식을 Markdown으로 변환:
    • PDF
    • 이미지
    • 오디오(받아쓰기 포함)
    • DOCX
    • XLSX
    • PPTX
  • 웹 콘텐츠를 Markdown으로 변환:
    • YouTube 영상 자막
    • Bing 검색 결과
    • 일반 웹 페이지
  • 이미 있는 Markdown 파일 가져오기

시작하기

  1. 이 저장소를 복제합니다

  2. 의존성을 설치합니다:

    bun install
    

    preinstall 단계가 .venv에 Python 가상환경을 만들고 markitdown[all]을 설치합니다.

  3. 프로젝트를 빌드합니다:

    bun run build
    
  4. 서버를 시작합니다:

    bun start
    

개발

  • bun run dev로 TypeScript 컴파일러를 감시 모드로 시작합니다
  • 서버 동작을 바꾸려면 src/server.ts를 고칩니다
  • 도구를 추가하거나 바꾸려면 src/tools.ts를 고칩니다

데스크톱 앱에서 쓰기

이 서버를 데스크톱 앱에 붙이려면 앱의 서버 설정에 다음을 추가하세요.

{
  "mcpServers": {
    "markdownify": {
      "command": "node",
      "args": [
        "{ABSOLUTE PATH TO FILE HERE}/dist/index.js"
      ]
    }
  }
}

환경 변수

모든 경로는 알맞은 기본값을 가집니다. 기본값이 내 설치 구조에 맞지 않을 때만 바꾸세요.

변수기본값용도
MARKITDOWN_PATH<project>/.venv/bin/markitdown, 없으면 PATH의 markitdownmarkitdown 실행 파일의 절대 경로. 포함된 가상환경 대신 시스템 전체에 설치했을 때(예: pipx install "markitdown[pdf]") 지정합니다.
REPOMIX_PATH<project>/node_modules/.bin/repomix, 없으면 PATH의 repomixgit-repo-to-markdown이 쓰는 repomix 실행 파일의 절대 경로.
MD_ALLOWED_PATHS설정 안 함(제한 없음)서버가 읽을 수 있는 폴더 목록(POSIX는 :, Windows는 ;로 구분). 설정하면 모든 파일 입력 도구(pdf-to-markdown, get-markdown-file 등)가 이 폴더 밖의 경로를 거부합니다.
MD_SHARE_DIR설정 안 함MD_ALLOWED_PATHS의 이전 이름(폴더 하나). 이전 버전과의 호환을 위해 아직 지원합니다.

Docker로 쓰기

빌드하고 실행합니다.

docker build -t markdownify-mcp .
docker run --rm -i \
  -v "$HOME/Documents:/data:ro" \
  -e MD_ALLOWED_PATHS=/data \
  markdownify-mcp

Docker MCP 카탈로그(mcp/markdownify)를 위한 참고 사항:

  • 서버가 읽을 호스트 폴더를 컨테이너에 마운트한 뒤, 도구에는 컨테이너 경로(예: /Users/you/Documents/foo.pdf가 아니라 /data/foo.pdf)를 넘기세요.
  • MD_ALLOWED_PATHS에 마운트한 폴더를 콜론으로 구분해 적으면, 서버가 바인드 마운트와 맞는 읽기 경계를 지킵니다.
  • 게시된 Docker 이미지에는 markitdown[pdf]만 들어 있어서, 오디오 받아쓰기와 이미지 OCR(audio-to-markdown, image-to-markdown)에 필요한 [all] 추가 구성이 없어 실패합니다. 모든 기능을 쓰려면 로컬 설치(bun install)를 쓰세요.

쓸 수 있는 도구

  • youtube-to-markdown: YouTube 영상을 Markdown으로 변환

  • pdf-to-markdown: PDF 파일을 Markdown으로 변환

  • bing-search-to-markdown: Bing 검색 결과를 Markdown으로 변환

  • webpage-to-markdown: 웹 페이지를 Markdown으로 변환

  • image-to-markdown: 이미지를 메타데이터와 함께 Markdown으로 변환

  • audio-to-markdown: 오디오 파일을 받아쓰기와 함께 Markdown으로 변환

  • docx-to-markdown: DOCX 파일을 Markdown으로 변환

  • xlsx-to-markdown: XLSX 파일을 Markdown으로 변환

  • pptx-to-markdown: PPTX 파일을 Markdown으로 변환

  • get-markdown-file: 이미 있는 Markdown 파일 가져오기. 파일 확장자는 *.md, *.markdown이어야 합니다.

    선택 사항: MD_ALLOWED_PATHS를 설정하면 모든 파일 입력 도구를 목록의 폴더로 제한합니다. 예: MD_ALLOWED_PATHS=/data/in:/data/out bun start.

기여하기

기여를 환영합니다! 편하게 풀 리퀘스트를 보내 주세요.

라이선스

이 프로젝트는 MIT 라이선스로 배포됩니다. 자세한 내용은 LICENSE 파일을 보세요.

저장소

zcaceres/markdownify-mcp