docjet-mcp

本地服务

docjet.dev生产力020 周前更新

代码仓库访问官网

关于 docjet-mcp

docjet-mcp 是用于 DocJet 的 MCP 服务，可通过模板或 HTML 与 JSON 数据生成品牌 PDF 和 PNG。适合需要文档或社交图片输出的 MCP 客户端用户，并返回签名下载 URL。

主要功能

01生成品牌 PDF
02生成 PNG 图片
03使用模板或原始 HTML
04列出可用模板
05返回签名下载 URL

适用场景

01根据模板数据创建发票
02生成报告 PDF
03制作证书
04渲染社交卡片

MCP 相关

它通过 stdio 向 MCP 客户端提供 DocJet 渲染和模板列表工具。渲染工具会返回签名下载 URL。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "docjet-dev-docjet": {
      "command": "npx",
      "args": [
        "-y",
        "docjet-mcp"
      ],
      "env": {
        "DOCJET_API_KEY": "<DOCJET_API_KEY>",
        "DOCJET_BASE_URL": "<DOCJET_BASE_URL>"
      }
    }
  }
}

启动命令npx -y docjet-mcp

需要配置的环境变量

DOCJET_API_KEY密钥DocJet API key (get one free at https://docjet.dev — POST /v1/signup)

DOCJET_BASE_URLOverride the API base URL (default: https://api.docjet.dev)

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmdocjet-mcp1.0.1stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
data	object	否	模板变量（Handlebars data 对象）
html	string	否	要渲染的原始 HTML（最大 512 KB）——与 template_id 二选一
template_id	string	否	来自 list_templates 的模板 ID（提供 template_id 或 html）

详细介绍

docjet-mcp

适用于 DocJet 的 MCP 服务——可直接从任何 MCP 客户端（Claude Desktop、Claude Code、Cursor、Windsurf 等）渲染带品牌标识的 PDF 文档（发票、报告、证书）和 PNG 社交图片。

发送模板 ID 或原始 HTML 以及 JSON 数据，即可获取签名下载 URL。通过 npx 在本地使用 stdio 运行，无需托管。

快速开始

将以下内容添加到 MCP 客户端配置中：

{
  "mcpServers": {
    "docjet": {
      "command": "npx",
      "args": ["docjet-mcp"],
      "env": {
        "DOCJET_API_KEY": "binfra_your_key_here"
      }
    }
  }
}

在 docjet.dev 获取 API 密钥。若想在不注册的情况下试用，可使用公开演示密钥（速率限制为每分钟 3 次请求、每月渲染 50 次，所有人共享）：

binfra_9afb57dbb6478c441ad101129fca65847f5745403f9d718b3de6d934c9b63f88

工具

工具	功能
`render_pdf`	渲染带品牌标识的 PDF。输入：`template_id`（或原始 `html`）+ `data` 对象。返回签名下载 URL。
`render_image`	渲染 PNG 图片（例如 OG／社交卡片）。输入：`template_id`（或原始 `html`）+ `data` 对象。返回签名下载 URL。
`list_templates`	列出可用模板：`id`、`name`、`description`、`outputType`。无需 API 密钥。

连接后可使用的提示词示例：

“列出 DocJet 模板，然后使用客户端名称为 ‘Demo SRL’、总额为 1000 的数据，将 invoice-ro 模板渲染为 PDF。”

环境变量

变量	必需	说明
`DOCJET_API_KEY`	是	你的 DocJet API 密钥（前缀为 `binfra_`）。作为 Bearer 令牌发送；绝不会记录到日志中。
`DOCJET_BASE_URL`	否	覆盖 API 基础 URL（默认为 `https://api.docjet.dev`）。

工作原理

使用官方 @modelcontextprotocol/sdk（v1）通过 Stdio 传输。
render_pdf → POST /v1/render?response=url，render_image → POST /v1/image?response=url，list_templates → GET /v1/templates。
发起任何网络请求前，都会在本地根据 ^[a-z0-9][a-z0-9-]{0,63}$ 验证模板 ID。
API 错误会作为 MCP 错误内容返回，并包含 DocJet 错误代码（例如 QUOTA_EXCEEDED、RATE_LIMITED）。