Markdownify MCP 서버

👁 markdownify mcp 로고

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

기능

• 여러 파일 형식을 마크다운으로 변환:

  • PDF

  • 이미지

  • 오디오 (전사 포함)

  • DOCX

  • XLSX

  • PPTX

• 웹 콘텐츠를 마크다운으로 변환:

  • YouTube 동영상 자막

  • Bing 검색 결과

  • 일반 웹 페이지

• 기존 마크다운 파일 검색

Related MCP server: Markdownify MCP Server - UTF-8 Enhanced

시작하기

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

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

   bun install

   preinstall 단계에서 .venv에 파이썬 가상 환경을 생성하고 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"
 ]
 }
 }
}

환경 변수

모든 경로는 기본적으로 적절한 값으로 설정되어 있습니다. 기본값이 설치 레이아웃에 맞지 않는 경우에만 재정의하십시오.

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 동영상을 마크다운으로 변환

• pdf-to-markdown: PDF 파일을 마크다운으로 변환

• bing-search-to-markdown: Bing 검색 결과를 마크다운으로 변환

• webpage-to-markdown: 웹 페이지를 마크다운으로 변환

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

• audio-to-markdown: 오디오 파일을 전사와 함께 마크다운으로 변환

• docx-to-markdown: DOCX 파일을 마크다운으로 변환

• xlsx-to-markdown: XLSX 파일을 마크다운으로 변환

• pptx-to-markdown: PPTX 파일을 마크다운으로 변환

• get-markdown-file: 기존 마크다운 파일을 검색합니다. 파일 확장자는 *.md, *.markdown으로 끝나야 합니다.

  선택 사항: MD_ALLOWED_PATHS를 설정하여 모든 파일 입력 도구를 디렉토리 목록으로 제한하십시오(예: MD_ALLOWED_PATHS=/data/in:/data/out bun start).

기여

기여를 환영합니다! 자유롭게 Pull Request를 제출해 주십시오.

라이선스

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 LICENSE 파일을 참조하십시오.

Maintenance

Resources

• NPM Package
• GitHub Repository
Need Help?
• Reddit Discussion
Related Servers

Tools

• audio-to-markdownB
• bing-search-to-markdownC
• docx-to-markdownC
• get-markdown-fileC
• image-to-markdownB
• pdf-to-markdownC
• pptx-to-markdownC
• webpage-to-markdownC