PDFMonkey

PDFMonkey MCP 服务

面向 PDFMonkey 的官方模型上下文协议（MCP）服务。它支持 Claude、Cursor 等 AI 助手或任何其他 MCP 客户端通过 PDFMonkey API 列出模板、生成文档并查看配额。

• 通过 stdio 在本地运行，并使用你的 API 密钥
• 已在 MCP Registry 中列出，名称为 io.github.pdfmonkey/pdfmonkey-mcp
• 文档：pdfmonkey.io/docs/integrations/mcp

MCP 服务适用于现有模板：它可以读取模板，但不能创建或编辑模板。要让 Agent 构建和预览模板，请使用 PDFMonkey CLI。

获取 API 密钥

在 dashboard.pdfmonkey.io/register 注册，然后从你的账户页面复制 API 密钥。

设置

此服务需要 Node.js 18 或更高版本，并从 PDFMONKEY_API_KEY 环境变量读取密钥。

Claude Code

claude mcp add pdfmonkey -e PDFMONKEY_API_KEY=your-api-key -- npx -y pdfmonkey-mcp-server

Claude Desktop、Cursor 和其他客户端

将以下内容添加到客户端的 MCP 配置中（Claude Desktop 使用 claude_desktop_config.json，Cursor 使用 .cursor/mcp.json）：

{
  "mcpServers": {
    "pdfmonkey": {
      "command": "npx",
      "args": ["-y", "pdfmonkey-mcp-server"],
      "env": {
        "PDFMONKEY_API_KEY": "your-api-key"
      }
    }
  }
}

在 macOS 上，Claude Desktop 的配置文件位于 ~/Library/Application Support/Claude/；在 Windows 上，位于 %APPDATA%\Claude\。

Docker

目前尚未发布镜像，因此请在本地构建：

docker build -t pdfmonkey-mcp-server .

{
  "mcpServers": {
    "pdfmonkey": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "PDFMONKEY_API_KEY", "pdfmonkey-mcp-server"],
      "env": {
        "PDFMONKEY_API_KEY": "your-api-key"
      }
    }
  }
}

请参阅 DOCKER-MCP-TOOLKIT.md，了解如何将其与 Docker MCP Toolkit 搭配使用。

工具

工具	功能说明
list_workspaces	列出你的 API 密钥可访问的工作区
list_templates	列出某个工作区的模板
get_template	获取模板的 HTML、CSS 和示例数据
generate_document	生成文档并等待生成完成（每隔 1.5 秒轮询一次，最长等待 3 分钟）
get_document_status	查看文档状态并获取其下载 URL
list_documents	按状态、模板或更新时间筛选并列出文档
delete_document	永久删除文档
list_snippets	列出某个工作区的 Liquid 代码片段
get_snippet	获取代码片段的代码
get_quota	获取你的配额和套餐
get_user_info	获取你的账户详情

此服务还提供四个提示词：list-templates-formatted、show-documents-status、generate-invoice 和 workspace-overview。

须知：

• 下载 URL 在一小时后过期。请立即下载文件，或使用分享链接（适用于 Pro+ 和 Premium 套餐）。
• 如果生成时间超过 3 分钟，请稍后使用文档 ID 调用 get_document_status。

示例

You: Generate an invoice for ACME with my invoice template.

Claude: [calls list_templates, then generate_document]
Your invoice is ready: https://…

开发

npm install
npm run build      # compile to dist/
npm test           # run the test suite
npm run watch      # rebuild on change

若要使用真实 API 测试此服务：

PDFMONKEY_API_KEY=your-api-key npm start

故障排除

• “PDFMONKEY_API_KEY environment variable is required”：客户端配置中缺少密钥。
• 401 错误：密钥错误或已重新生成。请从你的账户页面重新复制密钥。
• Docker 容器立即退出：使用 -i 运行；MCP 通过 stdin 通信。

资源

• PDFMonkey 文档
• MCP 服务文档
• PDFMonkey CLI
• API 参考

对服务有疑问？请提交 issue。对 PDFMonkey 本身有疑问？联系我们。

许可证

MIT，详见 LICENSE。