rendoc-mcp-server

@rendoc/mcp-server

rendoc MCP 服务让 Claude Desktop、Cursor 等 AI 助手以及任何兼容 MCP 的客户端按需生成专业 PDF 文档。将 AI 连接到 rendoc 后，它就能通过可复用模板或内联 HTML/Handlebars 标记，从自然语言提示词中生成发票、合同、报告、证书以及其他任何 PDF。

只需几秒，就能将 “为 Acme Corp 生成一张发票，包含 40 小时咨询服务，费率为 €85/h” 转换为一份已交付的 PDF。

使用场景

使用场景	示例提示词
发票	“为客户 X 生成一张包含以下明细的发票……”
合同	“为 TechStart SL 起草一份自由职业合同，费用为 €18,000，预付 50%……”
证书	“为 María González 签发一份课程结业证书……”
报告	“使用这些 KPI 创建一份 2026 年 3 月销售报告……”
批量生成	“为此 CSV 中的全部 50 位参会者生成证书”
自定义文档	任何可以用 HTML 和数据描述的内容

请参阅 examples/ 中的详细演示。

功能

• 7 个工具，用于文档生成、模板管理和用量跟踪
• 基于模板或内联生成——保存可复用模板，或即时传入标记
• Handlebars 语法——在标记中使用 {{variables}}、{{#each}}、{{#if}}
• 多种纸张尺寸——A4、Letter、Legal、A3、A5，支持纵向或横向
• 架构验证——模板可以声明 JSON Schema，避免 AI 传入无效数据
• 零配置——只需设置 RENDOC_API_KEY 即可使用
• 轻量——解包后约 35 KB，纯 TypeScript，仅有 2 个运行时依赖
• 已通过 Glama 验证——安全性、质量和许可证检查均已通过

Claude Desktop 快速设置

将以下内容添加到 Claude Desktop 配置文件（claude_desktop_config.json）：

{
  "mcpServers": {
    "rendoc": {
      "command": "npx",
      "args": ["-y", "@rendoc/mcp-server"],
      "env": {
        "RENDOC_API_KEY": "your-api-key"
      }
    }
  }
}

重启 Claude Desktop。rendoc 工具将显示在 MCP 工具菜单中。

Claude Code 快速设置

将以下内容添加到项目或全局设置（.claude/settings.json）：

{
  "mcpServers": {
    "rendoc": {
      "command": "npx",
      "args": ["-y", "@rendoc/mcp-server"],
      "env": {
        "RENDOC_API_KEY": "your-api-key"
      }
    }
  }
}

Cursor 快速设置

添加到 ~/.cursor/mcp.json（或项目的 .cursor/mcp.json）：

{
  "mcpServers": {
    "rendoc": {
      "command": "npx",
      "args": ["-y", "@rendoc/mcp-server"],
      "env": {
        "RENDOC_API_KEY": "your-api-key"
      }
    }
  }
}

可用工具

工具	描述	关键参数
generate_document	根据模板或内联标记生成 PDF	template_id 或 markup、data、paper_size?、orientation?、filename?
list_templates	列出可用的文档模板	category?
preview_template	查看模板的标记、样式和架构	template_id
create_template	创建新的可复用模板	name、slug、markup、schema、category?、styles?、sample_data?、paper_size?、orientation?、is_public?
delete_template	按 ID 删除模板	template_id
get_document	获取已生成文档的详细信息	document_id
get_usage	查看每月 API 用量统计	(无)

每个工具都会返回结构化 JSON，其中包含下载 URL、文档 ID 和助手可操作的元数据。

获取 API 密钥

1. 在 rendoc.dev 注册
2. 前往 API 密钥控制面板
3. 创建新密钥，并将其复制到 MCP 客户端配置中

环境变量

变量	必填	默认值	描述
RENDOC_API_KEY	是	—	用于身份验证的 rendoc API 密钥
RENDOC_API_URL	否	https://rendoc.dev	rendoc API 的基础 URL（适用于可自托管的实例）

示例

包含真实提示词和工具调用的详细演练：

• 01 — 根据内联标记生成发票 — 一次性生成发票
• 02 — 自由职业合同模板 — 创建一次，永久复用
• 03 — 根据已保存的模板生成证书 — 多步骤工具发现
• 04 — 月度销售报告 — 使用 CSS 创建丰富的可视化效果
• 05 — 根据数据集批量生成 — 根据一个提示词生成 50 份 PDF

工作原理

┌──────────────┐   MCP/stdio    ┌────────────────────┐   HTTPS   ┌─────────────┐
│ Claude Code  │ ─────────────▶ │ @rendoc/mcp-server │ ────────▶ │ rendoc API  │
│ / Desktop    │                │   (this package)    │           │  (PDF gen)  │
└──────────────┘ ◀───────────── └────────────────────┘ ◀──────── └─────────────┘
        ▲         tool results                        download URL
        │
        └── User prompt: "Generate an invoice for..."

MCP 服务会将 AI 助手发出的自然语言工具调用转换为经过身份验证的 REST 请求，发送到 rendoc API，并返回包含 PDF 下载 URL 的结构化响应。

贡献

欢迎贡献。开发环境设置和 PR 指南请参阅 CONTRIBUTING.md。

如有安全问题，请参阅 SECURITY.md，并发送邮件至 [email protected]——请勿创建公开 issue。

链接

• 网站：rendoc.dev
• 文档：rendoc.dev/docs
• npm 包：@rendoc/mcp-server
• Glama 收录页：glama.ai/mcp/servers/@yoryocoruxo-ai/rendoc-mcp-server
• 官方 SDK：@rendoc/sdk（TypeScript）、rendoc（Python）

许可证

MIT — 参见 LICENSE。