GuruPDF

io.github.GuruPDF由 GitHub 帳號 GuruPDF 發布v0.1.5更新於 Nov 7, 2026

Convert, compress & merge PDFs and 100+ file formats from any AI agent. By GuruPDF.

已驗證STDIO僅桌面效率與工作流檔案與儲存

概覽

AI 產生的概覽

GuruPDF 讓助手在本機讀寫檔案，完成 PDF 轉檔、壓縮、合併、拆分與編輯，並支援 100 多種檔案格式互轉。

可以做什麼
  • 把本機檔案或網址轉換、處理為目標格式（如 PDF、PNG、DOCX），或使用 compress-pdf、merge-pdf 等工具代號，結果儲存到磁碟
  • 合併、拆分、旋轉、加密與加上浮水印 PDF，並支援 OCR、電子書與圖片轉檔
  • 依任務 ID 查詢轉檔進度，長任務（如影片）完成後下載結果
  • 列出支援的轉檔與工具，可依輸入格式篩選
  • 查看剩餘額度及取得更多額度的方式
適用情境
適合讓助手處理日常文件事務：把 Word 發票轉成 PDF、壓縮報告、合併多個 PDF，或把網頁存成 PDF，不必手動上傳下載。
執行需求
需要 Node.js 18+ 和免費的 GuruPDF API 金鑰，透過 GURUPDF_API_KEY 環境變數設定，金鑰在 GuruPDF 個人資料頁建立。透過 npx 在本機執行；自架時可用 GURUPDF_API_URL 覆寫 API 位址。需要能連線到 GuruPDF 伺服器的網路。
安裝前請注意
轉檔在 GuruPDF 的伺服器上執行，所轉換的檔案會上傳到第三方，README 稱檔案會在一小時內自動刪除。每個工具都會消耗額度；免費帳號僅有每日額度並有限速，加值或升級涉及付費。API 金鑰屬於機密，勿寫入共用設定。伺服器會讀寫磁碟檔案，protect-pdf 需以選項傳入密碼。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 GuruPDF，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

GuruPDF MCP — convert PDFs & 100+ file formats from your AI agent

[npm version] [License: MIT] [gurupdf-mcp MCP server]

A free Model Context Protocol (MCP) server that lets Claude, Cursor, VS Code, Windsurf and other AI agents convert, compress, merge, split and edit PDFs — and convert between 100+ file formats (Word, Excel, PowerPoint, JPG, PNG, HEIC, ebooks, and more), right on your own machine. Powered by GuruPDF.

Languages: English · Español · Français · Deutsch · 中文 · Русский · Українська · Polski · Nederlands · Türkçe · Čeština · Ελληνικά · العربية

Ask your assistant: "compress this PDF", "turn invoice.docx into a PDF", or "merge these three files" — and it converts the files right on your machine.

  • 🗂️ 127 tools — PDF ⇄ Word/Excel/PowerPoint, images, ebooks, OCR, compress, merge, split, rotate, protect, watermark, and more.
  • 💻 Works on your local files — reads and writes files on disk, no manual upload/download.
  • 🆓 Free to start — every account gets daily credits. No credit card required.

Install

You need Node.js 18+ and a free GuruPDF API key:

  1. Sign up at gurupdf.com.
  2. Open Profile → API tokens and create a token.
  3. Add the server to your agent with that key (configs below). No install step — npx fetches it on first run.

Claude Desktop

claude_desktop_config.json:

json
{  "mcpServers": {    "gurupdf": {      "command": "npx",      "args": ["-y", "gurupdf-mcp"],      "env": { "GURUPDF_API_KEY": "your_token_here" }    }  }}

Cursor

~/.cursor/mcp.json (or .cursor/mcp.json in a project):

json
{  "mcpServers": {    "gurupdf": {      "command": "npx",      "args": ["-y", "gurupdf-mcp"],      "env": { "GURUPDF_API_KEY": "your_token_here" }    }  }}

VS Code

.vscode/mcp.json:

json
{  "servers": {    "gurupdf": {      "command": "npx",      "args": ["-y", "gurupdf-mcp"],      "env": { "GURUPDF_API_KEY": "your_token_here" }    }  }}

Windsurf

~/.codeium/windsurf/mcp_config.json:

json
{  "mcpServers": {    "gurupdf": {      "command": "npx",      "args": ["-y", "gurupdf-mcp"],      "env": { "GURUPDF_API_KEY": "your_token_here" }    }  }}

Tools

ToolWhat it does
convert_fileConvert/process a local file (or URL). Give it an input and a target format (pdf, png, docx…) or a tool slug (compress-pdf, merge-pdf…). Saves the result to disk.
get_statusCheck a conversion job by id and download the result when ready (for long jobs like video).
list_conversionsList supported conversions/tools, optionally filtered by an input format.
check_creditsShow remaining credits and how to get more.

Examples

"Compress ~/Documents/report.pdf." → convert_file(input: "~/Documents/report.pdf", to: "compress-pdf")

"Convert invoice.docx to PDF." → convert_file(input: "invoice.docx", to: "pdf")

"Merge a.pdf and b.pdf into one." → convert_file(input: ["a.pdf", "b.pdf"], to: "merge-pdf")

"Password-protect this PDF with hunter2." → convert_file(input: "secret.pdf", to: "protect-pdf", options: { password: "hunter2" })

"Save this web page as a PDF: https://example.com" → convert_file(input: "https://example.com", to: "url-to-pdf")

Free tier & credits

Each tool costs a few credits. Free accounts get daily credits (refreshed every day) and 2 conversions/minute, 10/day. When you run out, the assistant will tell you — you can wait for the daily refresh or top up / upgrade. Conversions run on GuruPDF's servers; files are deleted automatically within an hour.

Configuration

Env varDefaultNotes
GURUPDF_API_KEY—Required. Your API token from Profile → API tokens.
GURUPDF_API_URLhttps://gurupdf.com/api/v1Override only for self-hosted / staging.

Links

[gurupdf-mcp MCP server]

License

MIT

來源：README.md，提交 244d7cc

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

2
  1. v0.1.5最新Nov 7, 2026
  2. v0.1.4Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分