GuruPDF

GuruPDF MCP — 从 AI Agent 转换 PDF 和 100 多种文件格式

一个免费的 模型上下文协议 (MCP) 服务，可让 Claude、Cursor、VS Code、Windsurf 和其他 AI Agent 转换、压缩、合并、拆分和编辑 PDF，并在 100 多种文件格式之间进行转换（Word、Excel、PowerPoint、JPG、PNG、HEIC、电子书等），所有操作都在你自己的设备上完成。由 GuruPDF 提供支持。

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

告诉你的助手：“压缩这个 PDF”、“把 invoice.docx 转成 PDF”，或 “合并这三个文件”——它就会在你的设备上转换文件。

• 🗂️ 126 个工具 — PDF ⇄ Word/Excel/PowerPoint、图像、电子书、OCR、压缩、合并、拆分、旋转、保护、添加水印等。
• 💻 可处理本地文件 — 直接读取和写入磁盘上的文件，无需手动上传或下载。
• 🆓 免费开始使用 — 每个账户每天都会获得额度。无需信用卡。

安装

你需要 Node.js 18+ 和免费的 GuruPDF API 密钥：

1. 在 gurupdf.com 注册。
2. 打开 Profile → API tokens 并创建一个令牌。
3. 使用该密钥将服务添加到你的 Agent（配置见下文）。无需安装步骤——首次运行时，npx 会获取它。

Claude Desktop

claude_desktop_config.json：

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

Cursor

~/.cursor/mcp.json（或项目中的 .cursor/mcp.json）：

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

VS Code

.vscode/mcp.json：

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

Windsurf

~/.codeium/windsurf/mcp_config.json：

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

工具

工具	功能
convert_file	转换/处理本地文件（或 URL）。提供输入文件和目标格式（pdf、png、docx……）或工具标识（compress-pdf、merge-pdf……）。将结果保存到磁盘。
get_status	按 ID 查看转换任务，并在任务完成后下载结果（适用于视频等耗时较长的任务）。
list_conversions	列出支持的转换/工具，可选择按输入格式筛选。
check_credits	查看剩余额度以及如何获取更多额度。

示例

“压缩 ~/Documents/report.pdf。” → convert_file(input: "~/Documents/report.pdf", to: "compress-pdf")

“将 invoice.docx 转换为 PDF。” → convert_file(input: "invoice.docx", to: "pdf")

“将 a.pdf 和 b.pdf 合并成一个文件。” → convert_file(input: ["a.pdf", "b.pdf"], to: "merge-pdf")

“用密码 hunter2 保护这个 PDF。” → convert_file(input: "secret.pdf", to: "protect-pdf", options: { password: "hunter2" })

“将此网页保存为 PDF：https://example.com” → convert_file(input: "https://example.com", to: "url-to-pdf")

免费套餐与额度

每个工具会消耗少量额度。免费账户每天可获得每日额度（每天刷新），并且有每分钟 2 次、每天 10 次转换的限制。额度用完后，助手会告知你——你可以等待每日额度刷新，或充值/升级。转换在 GuruPDF 的服务器上运行；文件会在一小时内自动删除。

配置

环境变量	默认值	说明
GURUPDF_API_KEY	—	必填。 在 Profile → API tokens 获取你的 API 令牌。
GURUPDF_API_URL	https://gurupdf.com/api/v1	仅在自托管或预发布环境中覆盖。

链接

• Glama：Glama 上的 gurupdf-mcp

• 落地页：gurupdf.com/mcp
• 指南：使用 GuruPDF MCP 在 Claude 和 Cursor 中转换文件
• 网站：gurupdf.com
• API 文档：gurupdf.com/api/docs
• 定价：gurupdf.com/pricing

许可证

MIT