Claude와 Cursor에서 GuruPDF MCP로 파일 변환하기

코딩 에이전트는 앱을 스캐폴딩하고, 스택 트레이스를 풀어내고, 탭이냐 스페이스냐를 놓고 당신과 논쟁할 수 있습니다. 그런데 PDF를 주고 편집 가능한 Word 문서로 바꿔 달라고 하면 멈춥니다. 파일은 디스크에 있고, 모델은 채팅 안에 있습니다. 둘을 잇는 게 없습니다.

그 간극이 바로 GuruPDF MCP를 만든 이유입니다. Claude, Cursor, 그리고 다른 MCP 클라이언트가 실제로 파일을 변환할 수 있게 해주는 작은 서버입니다. 프롬프트에 경로를 넣고 원하는 걸 말하면, 잠시 뒤 변환된 파일이 디스크에 다시 놓입니다. 업로드 화면도, "다운로드한 다음 다른 곳에 다시 업로드"도 없습니다. 그냥 "convert ~/contracts/lease.pdf to Word."

What a file-conversion MCP actually is

MCP — Model Context Protocol — 은 AI 에이전트가 자기 머리 밖의 도구를 쓰게 해주는 플러그입니다. 서버가 몇 가지 동작을 노출하고, 에이전트는 프롬프트가 필요할 때 그걸 호출합니다. 데이터베이스, 브라우저, GitHub용 MCP 서버는 있습니다.

파일용으로 괜찮은 건 없었습니다. 그래서 PDF MCP — 실제로는 파일 변환 MCP입니다. PDF를 훨씬 넘어서니까요 — 는 한 형식의 파일을 받아 다른 형식으로 돌려주는 서버일 뿐입니다. PDF를 Word로. 이미지 폴더를 하나의 PDF로. 스캔한 페이지를 검색 가능한 텍스트로. 에이전트가 요청하고, GuruPDF가 변환합니다.

내부는 gurupdf.com 뒤에 있는 엔진과 같습니다. 126개 도구, 100개 이상의 형식. 이제 에디터 안에서 바로 쓸 수 있습니다.

Set it up in about two minutes

필요한 건 두 가지입니다. Node(npx용)와 무료 GuruPDF API 키. 키는 gurupdf.com/profile에서 받으세요. 무료 계정에도 매일 크레딧이 있어서 바로 변환을 시작할 수 있습니다.

서버는 npx로 설치되고 스스로 실행됩니다. 클론할 건 없습니다:

bash

npx gurupdf-mcp

직접 실행하진 않습니다. MCP 클라이언트가 그걸 가리키게 하면 됩니다. Cursor, Claude Desktop, VS Code, Windsurf라면 MCP 설정에 이걸 넣으세요:

json

{
  "mcpServers": {
    "gurupdf": {
      "command": "npx",
      "args": ["-y", "gurupdf-mcp"],
      "env": { "GURUPDF_API_KEY": "your-token-here" }
    }
  }
}

클라이언트를 재시작하면 에이전트가 조용히 도구 네 개를 얻습니다. 파일 변환, 작업 확인, 지원 목록, 크레딧 잔액 확인. 설정은 그게 전부입니다.

What you can actually do with it

여기가 재미있는 부분입니다. 연결만 되면, 이런 프롬프트가 그냥 됩니다:

"Convert ~/Downloads/invoice.pdf to Word so I can edit the totals." — 원본 옆에 편집 가능한 .docx가 생깁니다.
"Turn every screenshot in ~/shots into one PDF." — 이미지가 순서대로 합쳐져 하나의 파일이 됩니다.
"This scan is just an image. OCR it and give me the text." — 픽셀에서 실제 텍스트를 꺼냅니다.
"Compress report.pdf, it's 40 MB and I need to email it." — 읽기는 그대로인데 더 작은 파일.
"Make a PDF of https://example.com/pricing." — 실제 페이지를 PDF로 렌더링합니다.

도구 이름이나 형식을 외울 필요 없습니다. 목표를 평범한 말로 말하면 서버가 126개 도구 중 맞는 걸 고르고, 실행하고, 결과를 디스크에 씁니다. 병합, 분할, 회전, 암호 보호, 워터마크, Excel ↔ PDF, HEIC → JPG — 전부 들어 있습니다.

It talks back when something's off

대부분의 변환기는 알 수 없는 코드로 실패합니다. 이건 에이전트를 통해 설명하도록 만들어졌습니다. 답장을 읽는 쪽이 에이전트니까요.

무료 티어가 바닥나면 그냥 402가 오지 않습니다. 어시스턴트가 전해 주는 문장이 옵니다. 무료 한도에 도달했다(분당 2회, 하루 10회), 내일 리셋된다, 기다리기 싫으면 이 링크. 도구에 잘못된 형식을 주거나 파일이 너무 크면, 정확히 그걸 말해 줍니다. 오류 번호가 아니라 말로. 무슨 일이 있었는지 알아내려고 대화를 떠날 필요가 없습니다.

그 "에이전트를 통해 설명하라"는 생각 때문에 문구에도 공을 들입니다. 사람이 읽지 않는 오류 메시지도, 그걸 전달하는 모델에게는 말이 돼야 합니다.

What's under the hood

126개 도구, 100개 이상의 형식. PDF, Word, Excel, PowerPoint, 이미지, 전자책, 심지어 동영상까지 — 웹사이트와 같은 엔진입니다.
진짜 무료 티어. 모든 계정에 매일 크레딧이 지급됩니다. 더 많이 쓰려면 유료 플랜과 크레딧 번들이 있고, 에이전트는 그게 실제로 맞을 때만 안내합니다. 그 전에는 아닙니다.
파일은 남지 않습니다. 모든 전송은 HTTPS로 이뤄지고, 한 시간 안에 삭제됩니다. MCP가 결과를 디스크에 쓰고, 우리 쪽 사본은 곧 사라집니다.
오픈 소스. 서버는 MIT 라이선스이며 npm에 게시되고 공식 MCP 레지스트리에 등록되어 있습니다. 실행하기 전에 모든 줄을 읽을 수 있습니다.