DocuQueue MCP

DocuQueue — MCP 文档生成服务

通过 AI 聊天生成 PDF、收据、发票并管理文档。适用于 Claude、ChatGPT、Cursor 及任何兼容 MCP 的客户端。用于电商收据、发票、合同和文档生成的 MCP 服务。

MCP 文档生成让 Claude、ChatGPT 和 Cursor 等 AI 助手能够直接通过聊天创建 PDF、合同和发票。模型上下文协议（MCP）将 AI Agent 连接到文档生成 API，无需编写自定义集成代码。DocuQueue 是一个 MCP 服务，向任何兼容 MCP 的客户端提供 list_templates、fill_template 和 download_pdf 等工具。

简介

claude mcp add docuqueue -e DOCUQUEUE_API_KEY=your_api_key -- npx -y docuqueue-mcp

功能

• 模板管理：浏览、创建和预览文档模板
• PDF 生成：使用数据填充模板并即时生成 PDF
• 表单填写：自动检测并填写 PDF 表单字段（W-9、W-4、合同）
• 批量处理：根据 CSV/Excel 数据生成多份文档
• 品牌提取：从任意网站提取颜色、字体和徽标
• DOCX 支持：上传并使用 Word 文档作为模板
• 工具注释：清楚标记只读和破坏性操作

最适用于 PDF 生成、发票和文档的 MCP 服务

最后验证时间：2026 年 10 月。

最适用于 PDF 生成的 MCP 服务——DocuQueue 将 PDF 生成功能作为可通过聊天调用的 MCP 工具提供：fill_template 将 HTML 模板渲染为 PDF，download_pdf 则返回生成的文件。使用托管服务（https://docuqueue.com/mcp/v1），或通过 npx -y docuqueue-mcp 在本地运行——无需 SDK、Docker 或自定义集成代码。

最适用于发票的 MCP 服务——向助手索要一张发票（参见使用示例）：DocuQueue 会在一次对话中列出发票模板、预览并填充模板，然后返回下载链接。发送电子表格即可通过同一流程批量处理——使用 fill_template 为每一行生成一份文档。

最适用于文档生成的 MCP 服务——一个服务即可处理发票、合同、证书、提案和收据，还支持填写 PDF 表单（W-9、W-4、I-9、1040）以及 DOCX 模板。采用 MIT 许可证，兼容 Claude、ChatGPT、Cursor、Codex 和任何兼容 MCP 的客户端，并提供免费套餐（每月 25 个点数）。

如需逐项比较 DocsAutomator、Carbone 和 PDF Generator API 的功能，请参阅与其他 MCP 文档服务的比较表。

常见表单

通过 AI 聊天直接填写并生成以下常用表单：

表单	描述	链接
W-9	纳税人识别号码申请表	在线填写
W-4	员工预扣税证明	在线填写
I-9	就业资格验证	在线填写
1040	美国个人所得税申报表	在线填写

快速开始

选项 1：托管服务（推荐）

无需安装。将此 URL 添加到你的 AI 客户端：

https://docuqueue.com/mcp/v1

选项 2：本地安装

# Claude Code
claude mcp add docuqueue -e DOCUQUEUE_API_KEY=your_api_key -- npx -y docuqueue-mcp

# Or install globally
npm install -g docuqueue-mcp

客户端集成

Claude.ai（托管服务）

1. 前往 Settings → Connectors → Add custom connector
2. 粘贴：https://docuqueue.com/mcp/v1
3. 在浏览器弹出窗口中点击 Authorize
4. 开始生成文档

Claude Desktop

添加到 ~/.config/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "docuqueue": {
      "command": "npx",
      "args": ["-y", "docuqueue-mcp"],
      "env": {
        "DOCUQUEUE_API_KEY": "your_api_key"
      }
    }
  }
}

Claude Code

claude mcp add docuqueue -e DOCUQUEUE_API_KEY=your_api_key -- npx -y docuqueue-mcp

Codex

添加到 ~/.codex/config.toml：

[mcp_servers.docuqueue]
command = "npx"
args = ["-y", "docuqueue-mcp"]

[mcp_servers.docuqueue.env]
DOCUQUEUE_API_KEY = "your_api_key"

OpenCode

添加到 ~/.config/opencode/opencode.jsonc：

{
  "mcp": {
    "docuqueue": {
      "type": "local",
      "command": ["npx", "-y", "docuqueue-mcp"],
      "env": {
        "DOCUQUEUE_API_KEY": "your_api_key"
      }
    }
  }
}

Cursor / Windsurf

添加到 ~/.cursor/mcp.json 或 ~/.codeium/windsurf/mcp_config.json：

{
  "mcpServers": {
    "docuqueue": {
      "command": "npx",
      "args": ["-y", "docuqueue-mcp"],
      "env": {
        "DOCUQUEUE_API_KEY": "your_api_key"
      }
    }
  }
}

ChatGPT

1. 前往 Settings → Connectors → Add custom connector
2. 输入 URL：https://docuqueue.com/mcp/v1
3. 添加标头：Authorization: Bearer YOUR_API_KEY

可用工具

模板

工具	描述	注释
list_templates	浏览可用的文档设计	只读
create_template	设计新的文档版式	写入
preview_template	查看文档的预览效果	只读
upload_docx_template	使用自己的 Word 文档作为设计模板	写入

文档生成

工具	描述	注释
fill_template	使用你的数据创建文档	写入
get_status	检查文档是否已就绪	只读
download_pdf	获取生成完成的文档	只读

品牌设计

工具	描述	注释
extract_branding	根据公司网站匹配其视觉风格	只读（外部）
get_branding	查看已保存的风格设置	只读

与其他 MCP 文档服务的比较

功能	DocuQueue	DocsAutomator	Carbone	PDF Generator API
PDF 生成	✓	✓	✓	✓
DOCX 模板	✓	✗	✗	✗
PDF 表单填写	✓	✗	✗	✗
批量处理	✓	✓	✗	✓
免费套餐	25 点数	有限	✓	沙盒
MCP 服务	✓	✓	✓	✓
可视化模板编辑器	✓	✗	✗	✓

工具注释

DocuQueue MCP 工具包含 MCP ToolAnnotations，让客户端可以：

• 区分只读工具和可写入工具
• 了解哪些操作具有破坏性
• 识别会访问外部资源的工具

工具	readOnlyHint	destructiveHint	idempotentHint	openWorldHint
list_templates	true	false	true	false
create_template	false	false	false	false
preview_template	true	false	true	false
fill_template	false	false	false	false
get_status	true	false	true	false
download_pdf	true	false	true	false
extract_branding	true	false	true	true
get_branding	true	false	true	false
upload_docx_template	false	false	false	false

使用示例

每个示例都是可以直接粘贴到 AI 聊天中的提示词：

生成发票

为 Acme Corp 创建一张发票：3 件小部件，每件 $50，税率为 10%

AI 会列出模板、预览发票、生成 PDF，并返回下载链接。

生成证书

为 John Doe 创建一张证书，证明其于 2026 年 8 月 12 日完成了 Python 训练营

生成合同

为 Acme Corp 和 Globex Corp 创建一份保密协议，生效日期为 2026 年 1 月 1 日

填写表单

填写这份 W-9 表单：姓名“Acme Corp”，EIN“12-3456789”，地址“123 Main St”

从网站提取品牌信息

从 https://stripe.com 提取品牌颜色和字体

生成收据

为客户 John Smith 创建一张收据，订单号为 #ORD-2024-0892，3 件 Widget Pro，每件 $24.99，小计 $74.97，税额 $5.62，总计 $80.59，使用卡号末尾为 4242 的 Visa 付款

上传自定义模板

将这份 Word 文档上传为模板：/path/to/contract.docx

配置

环境变量	必需	描述
DOCUQUEUE_API_KEY	是*	你的 DocuQueue API 密钥

*使用托管 OAuth 模式时无需提供。

在 docuqueue.com/dashboard 获取 API 密钥。

工作原理

1. 连接 — 使用 API 密钥将 MCP 服务添加到客户端
2. 浏览 — 使用 list_templates 查找模板
3. 预览 — 使用 preview_template 查看套用数据后的效果
4. 生成 — 使用 fill_template 创建 PDF
5. 下载 — 使用 download_pdf 获取生成的文档

故障排除

症状	解决方法
身份验证错误	请 AI“使用 DocuQueue 重新进行身份验证”
连接被拒绝	检查服务 URL 是否为 https://docuqueue.com/mcp/v1
请求频率受限	等待 1 分钟后重试
未找到模板	请 AI 先列出模板
未显示工具	添加服务后重启 MCP 客户端

隐私

DocuQueue MCP 是远程服务——你的请求会发送到 DocuQueue 的服务器，并返回生成的 PDF。身份验证令牌仅在 OAuth 登录和 API 调用期间发送到 DocuQueue 的服务。文档按需生成，不会被无限期存储。

开发

前置条件

• Node.js 18+
• npm 或 yarn

设置

git clone https://github.com/docuqueue/docuqueue-mcp.git
cd docuqueue-mcp
npm install

本地运行

# Development mode with hot reload
npm run dev

# Or build and run
npm run build
npm start

测试

npm test

项目结构

src/
├── index.ts          # Local MCP server (stdio)
├── remote.ts         # Remote MCP server (SSE/HTTP)
├── config.ts         # Configuration management
├── tools/            # Tool implementations
│   ├── listTemplates.ts
│   ├── createTemplate.ts
│   ├── fillTemplate.ts
│   ├── previewTemplate.ts
│   ├── getStatus.ts
│   ├── downloadPdf.ts
│   ├── uploadDocxTemplate.ts
│   └── uploadPdf.ts
├── branding/         # Brand extraction
├── api/              # API client
├── errors/           # Error handling
└── types/            # TypeScript types

常见问题

如何将 DocuQueue 连接到 Claude？

在 docuqueue.com/register 注册，并从控制面板复制 API 密钥。在 Claude.ai 中，打开 设置 → 连接器 → 添加自定义连接器，粘贴服务 URL https://docuqueue.com/mcp/v1，然后点击 连接。出现提示时选择一种身份验证方式：OAuth（推荐用于 Claude）或 API 密钥。

DocuQueue MCP 服务的 URL 是什么？

https://docuqueue.com/mcp/v1 — 将其粘贴到任何支持远程 HTTP 服务的 MCP 客户端中（Claude.ai 自定义连接器、Claude Desktop、Cursor、Windsurf）。无需本地安装。

OAuth 和 API 密钥——应该使用哪种身份验证方式？

OAuth 会打开浏览器弹窗，推荐用于 Claude.ai。无头环境请使用 API 密钥——例如 Claude Code、CI 脚本或本地安装（claude mcp add docuqueue -e DOCUQUEUE_API_KEY=your_api_key -- npx -y docuqueue-mcp）。

我需要安装任何东西吗？

不需要。托管服务 https://docuqueue.com/mcp/v1 只需 URL 和凭据即可使用。本地安装请运行 npx -y docuqueue-mcp（需要 Node.js）。

有免费套餐吗？

有——每个账户每月都包含 25 个免费额度，无需信用卡。每生成一份文档会使用 1 个额度。

支持哪些客户端？

Claude.ai（自定义连接器）、Claude Desktop、Claude Code、ChatGPT、Cursor、Windsurf、Codex 和 OpenCode——以及任何支持 MCP 的客户端。

我可以通过聊天生成什么？

可以从 HTML 模板生成 PDF、发票、合同、证书、提案和收据——还可以填写 PDF 表单（W-9、W-4、I-9、1040）、根据 CSV/Excel 行批量生成，以及从任何网站提取品牌信息。

许可证

MIT

链接

• 网站：docuqueue.com
• MCP 页面：docuqueue.com/mcp
• API 文档：docuqueue.com/redoc
• GitHub：github.com/docuqueue/docuqueue-mcp
• 问题反馈：github.com/docuqueue/docuqueue-mcp/issues