SylphxAI/anymd

Any file → clean Markdown for AI agents: PDF, Word, PowerPoint, Excel, EPUB, HTML and web pages, images (OCR), audio and video (metadata, subtitles, transcripts). A fast Rust MCP server and CLI that runs on your machine. No API key.

anymd – 모든 파일을 AI 에이전트를 위한 깔끔한 Markdown으로 변환

기능 소개

  • 다양한 문서 형식(PDF, Word, PowerPoint, Excel, EPUB, HTML, 이미지, 오디오, 비디오 등)을 구조화된 Markdown으로 변환하는 Rust 기반의 빠르고 로컬에서 작동하는 서버/CLI 도구입니다. 출력물에는 페이지 단위 인용 앵커, 제목, 표, 이미지 및 선택적 OCR/ASR이 포함되며, LLM 프롬프트의 토큰 효율성을 극대화하도록 설계되었습니다.

AI 에이전트에게 중요한 이유

  • 에이전트(Claude, Gemini, Cursor 등)는 토큰 제한 내에 들어오는 깔끔하고 구조화된 텍스트가 필요합니다. anymd는 읽기 순서, 표, 인용을 보존하면서 모든 작업을 장치 내에서 처리(API 키 불필요, 데이터 업로드 없음)하여 단일 호출로 이를 제공합니다.

주요 특징

  • 속도 – Rust 기반 병렬 변환. 38개 문서 테스트 세트에서 docling보다 212배 빠름(총 11.5초).
  • 정확도 – 레이아웃 엔진이 글자 간격에서 단어를 재구성하고, 2단 논문 및 테두리 없는 표를 복구하며, 위첨자/아래첨자를 보존합니다.
  • 토큰 효율적 출력 – 간결한 front-matter, <!-- page N --> 앵커, 압축된 표.
  • 다중 형식 지원 – PDF, DOCX, PPTX, XLSX/ODS, CSV/TSV, EPUB, HTML, 이미지, 오디오, 비디오, URL 및 전체 디렉토리 지원.
  • 로컬 전용 – 클라우드 서비스 없음. OCR은 로컬 doc-VLM 모델 또는 Tesseract를 사용하며, ASR은 번들된 Qwen3-ASR을 사용합니다.
  • MCP 통합 – 4가지 Model-Context-Protocol 도구(outline, read, search, inspect)를 노출하여 MCP 호환 클라이언트에서 호출 가능.
  • Pro 애드온 – 29달러로 비디오 타임라인 프레임 추출 및 PDF 내 인용 위치를 검증하는 인용 확인 도구 제공.

사용 방법

  • npx -y @sylphx/anymd setup 명령어로 설치. 이 명령어는 시스템의 모든 MCP 클라이언트(Claude Code, Codex, Cursor, VS Code 등)에 바이너리를 등록합니다.
  • CLI 예시: anymd report.pdf > report.md, anymd https://example.com/article, anymd scan.png --ocr vlm.
  • MCP 서버로 실행(anymd mcp 또는 인수 없이 anymd 실행)하여 에이전트가 stdio를 통해 read, search 등을 요청하도록 설정.
  • npm, PyPI, Docker, crates.io에서 패키지 제공. 주요 플랫폼용 사전 빌드된 바이너리 제공.

벤치마크

  • 공개 AgentDocBench에서 종합 점수 96.4/100 기록(docling, kreuzberg, unstructured 등보다 우수).
  • 표 셀 F1 점수 92.2%, 읽기 순서 98.8%.
  • 38개 문서 변환에 총 11.5초 소요(docling은 2,432초).

보안 및 개인정보 보호

  • 모든 처리는 로컬에서 수행됩니다. URL 호출 시 엄격한 주소 검사가 수행됩니다.
  • 선택적 --allow-dir 옵션으로 파일 시스템 접근 제한 가능.
  • 이미지는 개인 디렉토리에 캐시되며 50MP로 제한됩니다.
  • 외부 도구(tesseract, ffmpeg)는 셸을 통하지 않고 타임아웃 설정과 함께 실행됩니다.

추가 정보

라이선스 – MIT(핵심 기능은 무료 오픈소스, Pro는 유료 애드온).

관련

  • 프로젝트
  • 프로젝트
  • 프로젝트
  • 프로젝트
  • 프로젝트