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

특징

• 여러 파일 형식을 마크다운으로 변환:
• PDF
• 이미지
• 오디오 (전사 포함)
• DOCX
• XLSX
• PPTX
• 웹 콘텐츠를 Markdown으로 변환하기:
• 유튜브 영상 대본
• 빙 검색 결과
• 일반 웹 페이지
• 기존 마크다운 파일 검색

시작하기

1. 이 저장소를 복제합니다
2. 의존성 설치:

preinstall 단계는 .venv에 파이썬 가상 환경을 생성하고 markitdown[all]를 설치합니다.

3. 프로젝트 구축:

4. 서버 시작:

개발

• bun run dev를 사용하여 TypeScript 컴파일러를 감시 모드로 시작하세요
• 서버 동작을 맞춤화하기 위해 src/server.ts를 수정합니다
• [[T5]에서 도구를 추가하거나 수정하는 방법

데스크톱 앱 사용

이 서버를 데스크톱 앱과 통합하려면 다음 사항을 앱 서버 구성에 추가하세요:

환경 변수

모든 경로는 기본값이 합리적인 값으로 설정되어 있습니다; 기본값이 설치 레이아웃에 맞지 않을 때만 오버라이드됩니다.

Markdownify MCP Server

Markdownify is a Model Context Protocol (MCP) server that converts various file types and web content to Markdown format. It provides a set of tools to transform PDFs, images, audio files, web pages, and more into easily readable and shareable Markdown text.

Features

• Convert multiple file types to Markdown:
  • PDF
  • Images
  • Audio (with transcription)
  • DOCX
  • XLSX
  • PPTX
• Convert web content to Markdown:
  • YouTube video transcripts
  • Bing search results
  • General web pages
• Retrieve existing Markdown files

Getting Started

1. Clone this repository

2. Install dependencies:

   bun install
   

   The preinstall step creates a Python virtual environment at .venv and installs markitdown[all].

3. Build the project:

   bun run build
   

4. Start the server:

   bun start
   

Development

• Use bun run dev to start the TypeScript compiler in watch mode
• Modify src/server.ts to customize server behavior
• Add or modify tools in src/tools.ts

Usage with Desktop App

To integrate this server with a desktop app, add the following to your app’s server configuration:

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

Environment variables

All paths default to sensible values; override only when the defaults don’t fit your install layout.

Usage with Docker

Build and run:

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

Notes for the Docker MCP catalog (mcp/markdownify):

• Mount any host directories you want the server to read into the container, then pass the container paths to the tools (e.g. /data/foo.pdf, not /Users/you/Documents/foo.pdf).