pdf-mcp의 개요
pdf-mcp는 PDF 작업 대부분을 다루는 명령줄 도구이자 MCP 서버입니다. 57개의 도구는 여러 묶음으로 나뉩니다. 양식 작성과 평탄화(9), 병합, 분할, 회전 같은 페이지 작업(8), 정규식 가림 처리, 워터마크, Bates 번호 매기기를 포함한 텍스트 도구(13), 텍스트, 표, 이미지, 링크 추출(7), 메타데이터(4), 서명과 서명 검증(6), Tesseract를 통한 OCR, 양식 자동 작성과 구조화된 데이터 추출을 위한 AI 도구, 그리고 일괄 처리입니다.
AI 도구는 기본적으로 로컬 비전 모델을 쓰고, 그다음 Ollama를 쓰며, 키를 넣었을 때만 OpenAI를 호출합니다. pypdf, fillpdf, PyMuPDF를 바탕으로 만들어졌습니다. 저장소는 Apache 2.0이지만 PyMuPDF는 AGPL-3.0입니다. 스타는 11개입니다. 마지막으로 태그된 릴리스는 2026년 2월의 v1.2.18이지만, README에는 v1.3 기능이 설명되어 있고 커밋도 계속되고 있습니다.
pdf-mcp 설치 방법
git clone, make install, pdf-mcp servepdf-mcp, 쓸 만한 가치가 있습니까?
인보이스, 양식, 스캔한 계약서는 사무 자동화가 흔히 막히는 지점입니다. pdf-mcp는 한 번의 설치로 이 범위를 모두 다룹니다. 같은 57개의 도구가 CLI 명령으로도 작동하므로, 에이전트가 해낸 작업을 스크립트로 바꿀 수 있습니다.
이런 문서에는 로컬 우선이 맞는 기본값입니다. OCR은 Tesseract로 실행됩니다. 원본 데이터로 양식을 자동 작성하고, 구조화된 필드를 추출하고, 문서를 분류하는 AI 기능은 로컬 비전 모델, 그다음 Ollama를 먼저 시도하고 OpenAI는 그 뒤에 씁니다. OpenAI에는 키를 명시적으로 넣어야 합니다.
주의할 점이 두 가지 있습니다. PDF의 가림 처리는 잘못되기 쉽습니다. 검은 상자 아래나 메타데이터에 텍스트가 남을 수 있으니, 가림 처리한 파일은 공유하기 전에 텍스트 추출기로 확인하십시오. 그리고 저장소에 Apache 2.0 배지가 붙어 있어도 PyMuPDF는 AGPL-3.0입니다. 배포하는 제품에 넣거나 네트워크 서비스로 운영한다면 이 점이 중요합니다.
프로젝트는 작습니다. 스타는 11개, 관리자는 한 명이고, 최신 태그 릴리스는 README보다 뒤처져 있습니다. 기능의 폭은 진짜지만, 실적은 아직 쌓이지 않았습니다.
제 역할을 하는 곳
매달 공급업체 인보이스 200건을 받는 15인 회사의 경리 담당자
인보이스 번호, 날짜, 합계를 스프레드시트로 옮기기
에이전트에게 폴더를 지정하고, 스캔본에는 OCR과 함께 extract_structured_data를 씁니다. 로컬 모델을 쓰면 문서가 컴퓨터 밖으로 나가지 않고 페이지당 비용도 들지 않습니다.
공개 자료 묶음을 준비하는 법률 보조원
증거물을 병합하고 Bates 번호를 붙이고 개인정보를 가리기
merge-pdfs, add-bates-numbering, redact-text-regex를 쓴 다음, 텍스트를 다시 추출해 가린 내용이 남아 있지 않은지 확인합니다.
도입 전 확인할 점
- 설정
- 저장소를 클론하고 make install(uv 기반)을 실행합니다. OCR에는 Tesseract가 필요합니다. pdf-mcp serve로 stdio 서버를 시작합니다.
- 연동
- Cursor, Claude Desktop 등 stdio MCP 클라이언트를 지원합니다. 스크립트와 CI용으로 전체 CLI가 있습니다.
- 데이터와 개인정보
- 처리는 로컬에서 실행됩니다. OpenAI 백엔드는 OPENAI_API_KEY가 설정된 경우에만 쓰입니다. 코드는 Apache 2.0, PyMuPDF는 AGPL-3.0입니다.
- 제한
- 스타 11개에 열린 issue 2개입니다. 최신 태그 릴리스(v1.2.18)는 README의 v1.3 기능보다 뒤처져 있습니다. 가림 처리가 제대로 되었는지는 사용자가 책임져야 합니다.
좋은 점
- 양식, OCR, 추출, 서명, 일괄 처리에 걸친 57개의 도구
- CLI와 MCP 서버에서 같은 도구를 씁니다
- AI 기능은 기본적으로 로컬 모델을 씁니다
- 법률 업무용 Bates 번호 매기기와 서명 검증
아쉬운 점
- PyMuPDF 의존성은 AGPL-3.0입니다
- 가림 처리 결과는 직접 확인해야 합니다
- 사용자층이 매우 작고, 릴리스가 README보다 뒤처집니다
추천 대상
인보이스, 양식, 스캔 문서를 처리하면서 그 작업을 자기 컴퓨터에서 하고 싶은 사람.
pdf-mcp 대안
pdf-mcp: 자주 묻는 질문
- pdf-mcp, 쓸 만한 가치가 있습니까?
- 우리가 찾은 에이전트용 로컬 PDF 도구 모음 중 가장 폭이 넓습니다. 다만 라이선스에 걸리는 부분이 있고, 가림 처리 기능은 직접 확인해야 합니다. 평점은 5점 만점에 3.5점입니다.
- pdf-mcp의 가격은 얼마입니까?
- 무료입니다. 코드는 Apache 2.0이고 AGPL-3.0 의존성(PyMuPDF)이 있습니다. 선택 사항인 OpenAI 백엔드는 별도로 과금됩니다.
- pdf-mcp의 단점은 무엇입니까?
- PyMuPDF 의존성은 AGPL-3.0입니다; 가림 처리 결과는 직접 확인해야 합니다; 사용자층이 매우 작고, 릴리스가 README보다 뒤처집니다.
- pdf-mcp에 적합한 사람은 누구입니까?
- 인보이스, 양식, 스캔 문서를 처리하면서 그 작업을 자기 컴퓨터에서 하고 싶은 사람.
- pdf-mcp에 회사 데이터를 맡겨도 안전합니까?
- 처리는 로컬에서 실행됩니다. OpenAI 백엔드는 OPENAI_API_KEY가 설정된 경우에만 쓰입니다. 코드는 Apache 2.0, PyMuPDF는 AGPL-3.0입니다.
- pdf-mcp의 가장 좋은 대안은 무엇입니까?
- 저희가 리뷰한 것 중 가장 가까운 대안은 Filesystem (reference server)입니다.
답변 확인일: 2026년 10월 24일.