@sheetrender/mcp

用于 SheetRender 的 MCP 服务器 — 让你的 AI 助手能够从 HTML 模板和电子表格数据渲染 PDF。

设置

从 sheetrender.com → 设置 → API 密钥获取 API 密钥，然后添加到你的 MCP 客户端配置中：

{
  "mcpServers": {
    "sheetrender": {
      "command": "npx",
      "args": ["-y", "@sheetrender/mcp"],
      "env": { "SHEETRENDER_API_KEY": "sr_live_..." }
    }
  }
}

SHEETRENDER_API_URL 也会被读取，默认为 https://sheetrender.com。仅当指向自托管或预发布实例时才需要设置它。

Related MCP server: Dokmatiq DocGen

工具

render_pdf

从你提供的 HTML 渲染一个 PDF。

返回保存的 PDF 的路径及其大小。如果小于 512 KB，它还会作为 base64 资源内联附加，因此显示附件的客户端会直接显示文档本身。

有两个服务器限制适用。超过 2 MB 的 HTML 会被拒绝 — 既测量你发送的内容，也测量在 data 替换后的文档，因此即使你编写的标记没有超限，展开长数据集的模板也可能超限。在免费计划中，每个渲染的 PDF 都会带有 "Made with SheetRender" 页脚 — 无论是来自 render_pdf 还是 render_template；付费计划则没有。

list_templates

无参数。返回每个已保存模板的名称、id 和最后更新日期。调用它可以将用户提到的模板名称转换为其他工具所需的 id。

render_template

从账户中已保存的模板渲染一个 PDF。

返回与 render_pdf 相同。

create_batch_job

排队一个后台任务，为已上传到项目的数据集中的每一行渲染一个 PDF。此服务器无法上传电子表格。

返回用于通过 get_job 轮询的任务 id。请注意，filename_template 和 group_by 会分别持久化到模板和项目中，因此它们也会更改后续运行的默认值。

如果服务器早于公共批处理端点，该工具会报告批处理任务不可用，而不是以晦涩的方式失败。

get_job

接受 job_id。返回状态、已完成和失败的行数，以及 — 一旦任务达到 succeeded、partial、failed 或 cancelled — 每个渲染文档的 id 和文件名。当任务处于 queued、retry_queued 或 running 状态时，文档列表保持为空。这些文档 id 就是 get_document 所接受的。

get_document

接受 document_id 并下载该单个渲染的 PDF。这些 id 来自已完成的批处理的 get_job；没有其他方式获取。返回与 render_pdf 相同 — 路径、大小，以及小于 512 KB 的内联 blob。

对于整个批处理，Web 应用中的合并 PDF 和 ZIP 比逐个获取每个文档更好。

page_settings

两个渲染工具共享，每个字段均可选：

{
  "page_size": "a4",
  "orientation": "portrait",
  "margins": { "top": 15, "right": 15, "bottom": 15, "left": 15 }
}

page_size 为小写 — a3、a4、a5、letter、legal 或 tabloid。边距是以毫米为单位的普通数字，不是 CSS 长度。

渲染的 PDF 写入系统临时目录。来自 API 的错误 — 密钥错误、模板缺失、速率限制 — 会作为携带服务器自身消息的工具错误返回。

公共 API 允许每个 API 密钥每分钟 120 个请求。超过后返回 429，工具会报告你已被限流，应稍后重试。批处理任务创建单独计量且更严格。

开发

无需主机 node/npm — scripts/dev.sh install、scripts/dev.sh deno task build。

MIT 许可。