Markdownify MCP 서버: MCP 프로토콜을 기반으로 다양한 콘텐츠를 마크다운 형식으로 변환합니다.

11.3K 00

일반 소개

마크다운파이 MCP Server는 모델 컨텍스트 프로토콜을 기반으로 하는 오픈 소스 도구로, GitHub에서 호스팅되며 개발자 Zach Caceres가 만들었습니다. 이 도구는 웹 콘텐츠뿐만 아니라 다양한 파일 유형(예: PDF, 이미지, 오디오, 오피스 문서 등)을 깔끔한 마크다운 형식으로 빠르게 변환하는 데 중점을 두고 있습니다. 이 도구는 개발자, 콘텐츠 제작자, 데이터 분석가 등 복잡한 정보를 정리하고, 문서를 생성하거나 콘텐츠를 추출해야 하는 사용자에게 특히 적합합니다. 간단한 설정 및 런타임 단계를 통해 사용자는 서로 다른 정보를 읽기 쉬운 마크다운 파일로 통합하여 생산성을 높일 수 있습니다. 이 프로젝트는 커뮤니티 기여를 지원하며, 코드는 투명하고 쉽게 확장할 수 있어 기술 애호가들이 추가 커스터마이징을 할 수 있습니다.

Markdownify MCP Server：基于MCP协议将各种内容转换为Markdown格式

기능 목록

문서 유형 변환PDF, Word, Excel 및 기타 오피스 문서를 마크다운으로 변환하세요.
이미지 텍스트 추출이미지에서 텍스트를 추출하고 OCR 기술을 사용하여 마크다운으로 변환합니다.
오디오 트랜스 크립 션오디오 파일을 텍스트로 변환하고 마크다운 형식으로 출력합니다.
웹 콘텐츠 추출: 지정된 URL에서 웹 페이지의 텍스트를 캡처하여 마크다운으로 변환합니다.
멀티 포맷 지원표, 슬라이드(PPT) 및 기타 여러 복잡한 형식의 변환과 호환됩니다.
명령줄 작업배치 파일 처리를 위한 간단한 명령줄 인터페이스를 제공합니다.
확장성MCP 프로토콜을 기반으로 사용자 정의 도구와 기능을 지원합니다.

도움말 사용

설치 프로세스

마크다운파이 MCP 서버를 사용하려면 로컬에서 환경을 설정해야 합니다. 다음은 자세한 설치 단계입니다:

클론 창고
- 터미널을 열고 다음 명령을 입력하여 프로젝트를 로컬로 복제합니다:
```
git clone https://github.com/zcaceres/markdownify-mcp.git
```
- 프로젝트 카탈로그로 이동합니다:
```
cd markdownify-mcp
```
종속성 설치
- 이 프로젝트는 Node.js 개발을 기반으로 하므로 Node.js가 로컬에 설치되어 있는지 확인해야 합니다(권장 버전은 LTS).
- 프로젝트 디렉토리에서 실행합니다:
```
npm install
```
- 그러면 다음과 같은 필요한 모든 종속성 패키지가 설치됩니다. uv(일반 처리용) 등을 입력합니다. 누락된 특정 도구를 묻는 메시지가 표시되는 경우(예 uv), 환경 변수를 수동으로 설치하고 구성해야 합니다. UV_PATH예를 들어
```
export UV_PATH="/path/to/uv"
```
빌드 및 실행
- 프로젝트 빌드:
```
npm run build
```
- 서버를 시작합니다:
```
npm start
```
- 또는 구성 파일에 따라 전체 명령어로 실행하세요:
```
node dist/index.js
```
- 서버가 시작되면 로컬 포트에서 수신 대기하고 파일 또는 URL이 입력될 때까지 기다립니다.

주요 기능 사용 방법

1. 로컬 파일을 마크다운으로 변환하기

절차::
1. 변환할 파일을 준비합니다(예 example.pdf및image.jpg 어쩌면 audio.mp3)를 프로젝트 디렉터리 또는 지정된 경로에 복사합니다.
2. 터미널에서 다음 명령을 실행합니다(파일 이름이 다음과 같다고 가정합니다. example.pdf):
```
node dist/index.js --file example.pdf --output result.md
```
3. 처리가 완료될 때까지 기다렸다가 파일을 출력합니다. result.md 파일이 지정된 디렉터리에 생성됩니다.
주의::
- 이미지 파일의 경우 시스템에 OCR 도구(예: 테서랙트)가 설치되어 있는지 확인하세요.
- 오디오 파일의 경우 음성 녹음 서비스를 추가로 구성해야 할 수도 있습니다.

2. 웹 콘텐츠를 마크다운으로 변환하기

절차::
1. 대상 페이지의 URL을 가져옵니다(예 https://example.com.
2. 터미널에 입력합니다:
```
node dist/index.js --url https://example.com --output webpage.md
```
3. 처리가 완료되면webpage.md 파일에는 페이지의 주 텍스트 콘텐츠가 마크다운 형식으로 포함됩니다.
주요 기능::
- YouTube 동영상 설명 또는 자막 추출 지원(관련 API로 작업해야 함).
- 중첩된 표 또는 복잡한 레이아웃이 있는 페이지를 처리합니다.

3. 여러 문서의 일괄 처리

절차::
1. 여러 파일을 폴더에 넣기(예 input_files).
2. 일괄 처리 명령을 실행합니다:
```
node dist/index.js --dir input_files --output-dir output_files
```
3. 각 파일에 대해 별도의 마크다운 파일이 생성되어 다음 폴더에 저장됩니다. output_files 폴더로 이동합니다.
최첨단::
- 많은 양의 문서나 정보를 정리하고 수동 작업 시간을 절약하는 데 이상적입니다.

4. 사용자 지정 도구 확장

절차::
1. 프로젝트의 dist/index.js 또는 관련 구성 파일.
2. 사용자 지정 OCR 모델이나 특정 웹 구문 분석 규칙과 같은 MCP 프로토콜 기반의 새로운 도구를 추가하세요.
3. 다시 빌드하고 실행하세요:
```
npm run build && npm start
```
적용 가능한 시나리오::
- 기본 기능이 요구 사항을 충족하지 않는 경우 프로그래밍 방식으로 기능을 확장할 수 있습니다.

운영 프로세스 세부 정보

문서 변환 프로세스::
1. 사용자가 파일 경로 또는 URL을 입력합니다.
2. 서버는 적절한 모듈(OCR, 전사 또는 웹 크롤링)을 호출하여 데이터를 처리합니다.
3. 결과는 마크다운으로 형식이 지정되고 지정된 파일로 출력됩니다.
오류 처리::
- 누락된 종속성이 발견되면 터미널에 다음과 같은 오류 메시지가 표시됩니다. uv not found확인해야 할 사항 UV_PATH 올바르게 구성되었는지 여부입니다.
- 네트워크 문제로 인해 페이지가 크롤링되지 않을 수 있으므로 URL이 유효한지 확인하는 것이 좋습니다.
최적화 권장 사항::
- 대용량 파일의 경우 메모리 오버플로우를 방지하기 위해 청킹을 권장합니다.
- 리포지토리 코드를 정기적으로 업데이트하여 최신 기능과 수정 사항이 사용되도록 합니다.