内容
# GuruPDF转换服务器 — 在您的AI代理中转换PDF和100多种文件格式
[](https://www.npmjs.com/package/gurupdf-mcp)
[](https://github.com/GuruPDF/gurupdf-mcp/blob/main/LICENSE)
[](https://glama.ai/mcp/servers/GuruPDF/gurupdf-mcp)
一个免费的 **[模型上下文协议](https://modelcontextprotocol.io) (MCP) 服务器**，允许Claude、Cursor、VS Code、Windsurf和其他AI代理 **转换、压缩、合并、分割和编辑PDF文件**，以及 **在100多种文件格式之间转换**（Word、Excel、PowerPoint、JPG、PNG、HEIC、电子书等），直接在您的机器上运行。由 [GuruPDF](https://gurupdf.com) 提供支持。
**语言：** 英语 · [西班牙语](i18n/README.es.md) · [法语](i18n/README.fr.md) · [德语](i18n/README.de.md) · [中文](i18n/README.zh.md) · [俄语](i18n/README.ru.md) · [乌克兰语](i18n/README.uk.md) · [波兰语](i18n/README.pl.md) · [荷兰语](i18n/README.nl.md) · [土耳其语](i18n/README.tr.md) · [捷克语](i18n/README.cs.md) · [希腊语](i18n/README.el.md) · [阿拉伯语](i18n/README.ar.md)
> 问您的助手： *"压缩这个PDF文件"*, *"将invoice.docx转换为PDF文件"*, 或 *"合并这三个文件"* — 它会在您的机器上直接转换文件。
- 🗂️ **126种工具** — PDF ⇄ Word/Excel/PowerPoint, 图片, 电子书, OCR, 压缩, 合并, 分割, 旋转, 保护, 水印等。
- 💻 **在您的本地文件上工作** — 读取和写入磁盘上的文件，无需手动上传/下载。
- 🆓 **免费开始** — 每个账户每天都有积分。无需信用卡。
## 安装
您需要 **Node.js 18+** 和一个免费的 **GuruPDF API密钥**：
1. 在 **[gurupdf.com](https://gurupdf.com)** 注册。
2. 打开 **[个人资料 → API令牌](https://gurupdf.com/profile)** 并创建一个令牌。
3. 使用该密钥（下面的配置）将服务器添加到您的代理中。无需安装步骤 — `npx`会在首次运行时获取它。
### Claude Desktop
`claude_desktop_config.json`:
```json
{
"mcpServers": {
"gurupdf": {
"command": "npx",
"args": ["-y", "gurupdf-mcp"],
"env": { "GURUPDF_API_KEY": "您的令牌" }
}
}
}
```
### Cursor
`~/.cursor/mcp.json` （或 `.cursor/mcp.json` 在项目中）：
```json
{
"mcpServers": {
"gurupdf": {
"command": "npx",
"args": ["-y", "gurupdf-mcp"],
"env": { "GURUPDF_API_KEY": "您的令牌" }
}
}
}
```
### VS Code
`.vscode/mcp.json`:
```json
{
"servers": {
"gurupdf": {
"command": "npx",
"args": ["-y", "gurupdf-mcp"],
"env": { "GURUPDF_API_KEY": "您的令牌" }
}
}
}
```
### Windsurf
`~/.codeium/windsurf/mcp_config.json`:
```json
{
"mcpServers": {
"gurupdf": {
"command": "npx",
"args": ["-y", "gurupdf-mcp"],
"env": { "GURUPDF_API_KEY": "您的令牌" }
}
}
}
```
## 工具
| 工具 | 功能 |
|------|--------------|
| `convert_file` | 转换/处理本地文件（或URL）。提供输入和目标格式（`pdf`, `png`, `docx`…）或工具 slug（`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次/天**。当您用完积分时，助手会告诉您 — 您可以等待每日刷新或 [充值/升级](https://gurupdf.com/pricing)。转换在GuruPDF的服务器上运行；文件在1小时内自动删除。
## 配置
| 环境变量 | 默认值 | 备注 |
|---------|---------|-------|
| `GURUPDF_API_KEY` | — | **必填。** 从 [个人资料 → API令牌](https://gurupdf.com/profile) 获取的API令牌。 |
| `GURUPDF_API_URL` | `https://gurupdf.com/api/v1` | 仅适用于自托管/预发布环境。 |
## 链接
- Glama: [GuruPDF转换服务器](https://glama.ai/mcp/servers/GuruPDF/gurupdf-mcp)
[](https://glama.ai/mcp/servers/GuruPDF/gurupdf-mcp)
- 主页: [gurupdf.com/mcp](https://gurupdf.com/mcp)
- 指南: [在Claude和Cursor中转换文件，借助GuruPDF MCP](https://gurupdf.com/blog/file-conversion-mcp-for-claude-and-cursor)
- 网站: [gurupdf.com](https://gurupdf.com)
- API文档: [gurupdf.com/api/docs](https://gurupdf.com/api/docs)
- 定价: [gurupdf.com/pricing](https://gurupdf.com/pricing)
## 许可证
MIT
