AI 에이전트가 웹 페이지를 검색하고 스크래핑하며 상호작용할 수 있는 API로, 정제된 Markdown, JSON, 스크린샷을 반환합니다.
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
이 리포지토리를 클론합니다
- 2
종속성을 설치합니다(markitdown이 포함된 Python 가상 환경도 생성됩니다)
bun install - 3
프로젝트를 빌드합니다
bun run build - 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 통계는 매일 갱신됩니다.
관련 프로젝트
생성형 AI 파이프라인에서 사용할 수 있도록 PDF, Office 문서, HTML 등을 구조화된 데이터로 변환하는 오픈소스 문서 파서입니다.
Claude나 ChatGPT 같은 LLM에 전달할 수 있도록 전체 코드 저장소를 하나의 AI 친화적인 파일로 묶는 CLI 및 웹 도구입니다.
PDF를 Markdown, 바운딩 박스가 포함된 JSON, HTML로 변환하고, 태그가 없는 PDF에 자동으로 태그를 추가해 Tagged PDF로 만드는 오픈소스 파서입니다.
일반 .chat.md 파일을 MCP 도구를 지원하는 편집 가능한 AI 채팅 세션으로 바꿔 주는 VS Code 확장 프로그램입니다.
LLM 에이전트의 대화와 실행을 Python 및 TypeScript 앱에서 활용할 수 있는 영구적이고 구조화된 메모리로 바꾸는 에이전트 네이티브 메모리 인프라입니다.