Pdfmakerapi

远程服务

pdfmakerapi.com生产力018 周前更新

代码仓库访问官网

关于 Pdfmakerapi

Pdfmakerapi 是面向 MCP 客户端的 PDFMakerAPI 服务端，将自然语言文档描述转换为可分享链接，可在编辑器中预览、修改并下载 PDF。它提供单个 create_document 工具，并支持本地配置或远程连接。

主要功能

01通过描述生成 PDF 文档
02返回可分享的编辑链接
03在编辑器预览并修改字段
04支持本地与远程连接

适用场景

01生成发票和收据
02制作证书与报告
03创建简历和合同
04让他人通过链接填写文档

MCP 相关

该 MCP 服务向客户端提供 create_document 工具，将文档描述提交给 PDFMakerAPI，并返回可打开的文档链接。客户端可本地安装连接，也可使用远程端点 https://api.pdfmakerapi.com/mcp。

配置

远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。

服务地址https://api.pdfmakerapi.com/mcp

一键复制安装命令

Claude CodeTerminalclaude mcp add --transport http pdfmakerapi https://api.pdfmakerapi.com/mcp

Cursor.cursor/mcp.json{"mcpServers":{"pdfmakerapi":{"type":"http","url":"https://api.pdfmakerapi.com/mcp"}}}在 Cursor 中打开

VS Code.vscode/mcp.json{"servers":{"pdfmakerapi":{"type":"http","url":"https://api.pdfmakerapi.com/mcp"}}}在 VS Code 中打开

Claude Desktopclaude_desktop_config.json{"mcpServers":{"pdfmakerapi":{"type":"http","url":"https://api.pdfmakerapi.com/mcp"}}}

Windsurf~/.codeium/windsurf/mcp_config.json{"mcpServers":{"pdfmakerapi":{"serverUrl":"https://api.pdfmakerapi.com/mcp"}}}

命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

安装包

npm@pdfmakerapi/mcp1.0.0stdio

工具

参数	类型	必填	说明
document	object	是	要创建的 PDFMakerAPI Document。请遵循此工具描述中的 DOCUMENT MODEL。
document.id	string	否
document.name	string	否	文档名称。
document.description	string	否
document.pageSize	string	否	“letter” \| “a4” \| “legal” \| “letter-landscape” \| “a4-landscape” \| “square” \| “auto”（默认值为 “a4”；“auto” 会自动增加高度以适应内容，适用于证书／奖项）。
document.pageBackgroundColor	string	否	十六进制颜色，例如 #ffffff。
document.margin	string	否	“none” \| “sm” \| “md” \| “lg”（默认值为 “lg”）。
document.gap	string	否	“none” \| “sm” \| “md” \| “lg”（默认值为 “lg”）。
document.variables	array	否	声明的变量；内容中使用的每个 {{name}} 都必须在此处声明。
document.children	array	否	文档正文——按顺序排列的节点数组（container/text/table/spacer/divider）。请参阅上文的 DOCUMENT MODEL。

详细介绍

PDFMakerAPI MCP 服务

这是一个面向 PDFMakerAPI 的 MCP 服务。它提供一个 create_document 工具，可将通俗易懂的文档描述转换为一个可分享的链接，打开后即可进入 PDFMakerAPI 编辑器，预览文档、编辑任意字段并下载 PDF。

支持 Claude Desktop、Claude.ai、Cursor、Windsurf、Cline、Zed、VS Code、ChatGPT 以及任何其他 MCP 客户端。它是 https://api.pdfmakerapi.com 公共 API 的轻量客户端，因此无需账号或凭据。

什么是 PDFMakerAPI？

PDFMakerAPI 是一个 PDF 模板构建器和 PDF 生成 API。无需将文档硬编码，也不必费力处理内容一变就会出错的 HTML 转 PDF 转换器；只需在可视化免代码编辑器中设计一次可重复使用的模板，将文本、表格、图片和动态字段放置在所需位置，然后填入数据即可生成完整且可编辑的 PDF。

既可以生成单份文档，也可以生成数千份。你可以自行填写模板、分享链接让任何人在浏览器中完成可填写的 PDF 表单、向 REST API 发送 JSON、通过 Zapier、Make 和 n8n 等免代码工具触发生成，也可以直接通过 Claude 和 ChatGPT 等 AI Agent 创建文档。想从提示词开始？描述你的需求，让 Quill 为你构建。

团队使用 PDFMakerAPI 创建发票、收据、证书、报告和合同——适用于所有原本需要在数据变化时手动重新制作的文档。免费开始构建，每月可生成 100 份 PDF。

快速安装

一键安装：

也可以手动添加相同配置（适用于所有桌面客户端）：

{
  "mcpServers": {
    "pdfmakerapi": {
      "command": "npx",
      "args": ["-y", "@pdfmakerapi/mcp"]
    }
  }
}

按客户端配置

Claude Desktop

进入 Settings → Developer → Edit Config（claude_desktop_config.json），添加上方的 mcpServers 块，然后重启 Claude。

Cursor

使用 Add to Cursor 按钮，或将配置块添加到 ~/.cursor/mcp.json（全局）或 .cursor/mcp.json（按项目）。

Windsurf

将配置块添加到 ~/.codeium/windsurf/mcp_config.json（或通过 Settings → Cascade → MCP 添加）。

Cline

进入 Cline → MCP Servers → Configure，然后添加 mcpServers 块。

VS Code

使用 Install in VS Code 按钮，或添加到 .vscode/mcp.json（注意：VS Code 使用 servers 键）：

{
  "servers": {
    "pdfmakerapi": { "command": "npx", "args": ["-y", "@pdfmakerapi/mcp"] }
  }
}

Zed

在 settings.json 中：

{
  "context_servers": {
    "pdfmakerapi": { "command": { "path": "npx", "args": ["-y", "@pdfmakerapi/mcp"] } }
  }
}

## 托管（远程）选项 — 无需安装

如果你的客户端支持远程 MCP 服务，只需将其指向托管端点即可——无需 npx，也无需 Node：

https://api.pdfmakerapi.com/mcp

Claude.ai（网页）： 设置 → 连接器 → 添加自定义连接器 → 粘贴 URL。
ChatGPT（Plus/Pro/Enterprise）： 设置 → 连接器 → 添加 URL。
Cursor / 其他： 添加 { "url": "https://api.pdfmakerapi.com/mcp" }，而不是 command/args。

用法

请助手创建文档：

“为 Acme 制作一份包含 3 个行项目的专业发票。” “创建一张课程结业证书。” “制作一份简洁的单页简历。”

它会调用 create_document，并返回一个类似 https://app.pdfmakerapi.com/d/<id> 的链接——打开链接即可预览、编辑任意字段并下载 PDF。

配置

环境变量	默认值	用途
`PDFMAKERAPI_BASE_URL`	`https://api.pdfmakerapi.com`	指向其他 API（例如用于本地开发的 `http://localhost:3001`）。

开发

git clone https://github.com/GerardoBarrera/pdfmakerapi-mcp.git
cd pdfmakerapi-mcp
npm install
npm run build   # compile to dist/
npm run dev     # run from source (tsx)

故障排除

服务未显示在客户端中 — 编辑 MCP 配置后重启客户端，并检查 JSON 是否有效（末尾不要有逗号）。对于远程客户端，请确认 URL 完全为 https://api.pdfmakerapi.com/mcp。
npx 启动失败 — 确保已安装 Node.js 18+（node -v），然后重试 npx -y @pdfmakerapi/mcp@latest。
远程端点连接超时 — 确认你的网络/代理允许通过 HTTPS 访问 api.pdfmakerapi.com，并且使用的是 Streamable HTTP 传输方式。
“文档过大” — 文档的 JSON 大小上限约为 1 MB；请精简大型表格或拆分成多个文档。
返回的链接无法打开 — 复制完整链接（末尾包含文档 ID）；如果出现 404，请重新生成文档。
仍无法解决？ — 提交 GitHub 问题或发送邮件至 [email protected]。