Markdownify MCP
- 추천0
- GitHub 별3K
- 문서라이선스MIT
PDF · 이미지 · 오디오 · DOCX · XLSX · PPTX · 웹 페이지 · YouTube 자막을 Markdown으로 바꿔 주는 MCP 서버. MIT
설치 방법은 설치 탭에 정리했어요.
설명
Markdownify MCP 서버

Markdownify는 여러 파일 형식과 웹 콘텐츠를 Markdown으로 바꿔 주는 Model Context Protocol(MCP) 서버입니다. PDF, 이미지, 오디오 파일, 웹 페이지 등을 읽고 공유하기 쉬운 Markdown 텍스트로 바꾸는 도구 모음을 제공합니다.
기능
- 여러 파일 형식을 Markdown으로 변환:
- 이미지
- 오디오(받아쓰기 포함)
- DOCX
- XLSX
- PPTX
- 웹 콘텐츠를 Markdown으로 변환:
- YouTube 영상 자막
- Bing 검색 결과
- 일반 웹 페이지
- 이미 있는 Markdown 파일 가져오기
시작하기
-
이 저장소를 복제합니다
-
의존성을 설치합니다:
bun installpreinstall단계가.venv에 Python 가상환경을 만들고markitdown[all]을 설치합니다. -
프로젝트를 빌드합니다:
bun run build -
서버를 시작합니다:
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의 markitdown | markitdown 실행 파일의 절대 경로. 포함된 가상환경 대신 시스템 전체에 설치했을 때(예: pipx install "markitdown[pdf]") 지정합니다. |
REPOMIX_PATH | <project>/node_modules/.bin/repomix, 없으면 PATH의 repomix | git-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 파일을 보세요.