Chuyển đổi tệp trong Claude và Cursor với GuruPDF MCP

Agent lập trình của bạn có thể dựng khung một ứng dụng, gỡ rối stack trace, rồi tranh luận với bạn về tab hay space. Đưa cho nó một PDF và bảo xuất ra Word có thể chỉnh sửa thì nó đứng hình. File nằm trên đĩa; mô hình nằm trong chat. Không có gì nối hai bên với nhau.

Khoảng trống đó chính là lý do chúng tôi xây GuruPDF MCP — một server nhỏ giúp Claude, Cursor và bất kỳ MCP client nào khác thực sự chuyển đổi được file. Đưa đường dẫn vào prompt, nói bạn muốn gì, và file đã chuyển nằm lại trên đĩa chỉ một lúc sau. Không màn hình upload, không "tải về rồi upload lại chỗ khác." Chỉ "convert ~/contracts/lease.pdf to Word."

What a file-conversion MCP actually is

MCP — Model Context Protocol — là phích cắm để AI agent dùng công cụ bên ngoài cái đầu của nó. Một server mở ra vài hành động; agent gọi chúng khi prompt của bạn cần. Có MCP server cho database, trình duyệt, GitHub.

Chưa có cái nào tử tế cho file. Vì vậy PDF MCP — thực ra là file-conversion MCP, vì nó đi xa hơn PDF rất nhiều — chỉ là một server nhận file một định dạng và trả lại định dạng khác. PDF sang Word. Một thư mục ảnh thành một PDF. Một trang scan thành văn bản tìm kiếm được. Agent lo việc hỏi; GuruPDF lo việc chuyển.

Bên dưới là cùng engine của gurupdf.com: 126 công cụ, 100+ định dạng, giờ gọi được ngay trong editor.

Set it up in about two minutes

Bạn cần hai thứ: Node (cho npx) và một GuruPDF API key miễn phí. Lấy key tại gurupdf.com/profile — tài khoản miễn phí có credit mỗi ngày, nên bạn chuyển được ngay.

Server tự cài và tự chạy qua npx; không cần clone gì:

bash

npx gurupdf-mcp

Bạn sẽ không gõ lệnh đó tay — bạn trỏ MCP client tới nó. Với Cursor, Claude Desktop, VS Code hoặc Windsurf, thả đoạn này vào MCP config:

json

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

Khởi động lại client và agent của bạn lặng lẽ có thêm bốn công cụ: chuyển một file, kiểm tra job, liệt kê những gì được hỗ trợ, và xem số credit. Đó là toàn bộ bước cài.

What you can actually do with it

Đây là phần thú vị. Khi đã nối xong, đây là những prompt thật sự chạy được:

"Convert ~/Downloads/invoice.pdf to Word so I can edit the totals." — một .docx có thể chỉnh sửa xuất hiện cạnh file gốc.
"Turn every screenshot in ~/shots into one PDF." — ảnh được gộp, đúng thứ tự, thành một file.
"This scan is just an image. OCR it and give me the text." — văn bản thật được kéo ra từ pixel.
"Compress report.pdf, it's 40 MB and I need to email it." — file nhỏ hơn, vẫn đọc được.
"Make a PDF of https://example.com/pricing." — trang đang sống, render thành PDF.

Bạn không cần nhớ tên công cụ hay định dạng. Nói mục tiêu bằng ngôn ngữ thường, server chọn trong 126 công cụ cái nào khớp, chạy, rồi ghi kết quả ra đĩa. Merge, split, rotate, password-protect, watermark, Excel ↔ PDF, HEIC → JPG — đều có trong đó.

It talks back when something's off

Hầu hết converter thất bại bằng một mã khó hiểu. Cái này được thiết kế để tự giải thích qua agent của bạn, vì agent mới là thứ đọc câu trả lời.

Hết hạn mức miễn phí thì bạn không nhận một 402 trơ trọi. Bạn nhận một câu mà trợ lý chuyển lại: bạn đã chạm giới hạn miễn phí (2 lần chuyển mỗi phút, 10 lần mỗi ngày), reset vào ngày mai, và đây là link nếu bạn không muốn đợi. Đưa sai định dạng, hoặc file quá lớn, nó nói đúng chuyện đó — bằng lời, không phải mã lỗi. Bạn không phải rời cuộc trò chuyện để hiểu chuyện gì xảy ra.

Ý tưởng "giải thích qua agent" cũng là lý do chúng tôi kỹ với từng câu chữ. Một thông báo lỗi mà người không bao giờ đọc vẫn phải có nghĩa với mô hình đang chuyển nó.

What's under the hood

126 công cụ, 100+ định dạng. PDF, Word, Excel, PowerPoint, ảnh, e-book, cả video — cùng engine với website.
Hạn mức miễn phí thật sự. Mỗi tài khoản có credit mỗi ngày. Gói trả phí và gói credit dành cho nhu cầu nặng hơn, và agent chỉ chỉ bạn tới chúng khi thực sự hợp lý, không phải trước đó.
File không nằm lại. Mọi thứ đi qua HTTPS và bị xóa trong vòng một giờ. MCP ghi kết quả ra đĩa của bạn; bản sao phía chúng tôi biến mất ngay sau đó.
Open source. Server dùng giấy phép MIT, đăng trên npm và nằm trong MCP registry chính thức, nên bạn đọc được từng dòng trước khi chạy.

Get it

Nếu cả ngày bạn ở trong Claude hoặc Cursor rồi cứ phải nhảy ra một trang converter, cái này xóa luôn vòng đi vòng lại đó.

Install: npx gurupdf-mcp
Package: npmjs.com/package/gurupdf-mcp
Registry: tìm "GuruPDF" trong MCP registry chính thức
API key: gurupdf.com/profile

Cài một lần rồi quên nó đi — cho đến lần tiếp theo lẽ ra bạn phải mở tab trình duyệt để chuyển file, và agent của bạn làm thay.