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 分