DocMake

@docmake/mcp

DocMake 的官方 Model Context Protocol 服务。DocMake 是一个 AI 原生文档生成平台。它可以让 Claude 等 AI 助手根据你的 DocMake 模板生成 DOCX 和 PDF 文档：无需编写胶水代码，只需对话即可。

“为 Acme Corp 生成发票：10 小时咨询服务，每小时 100 EUR，14 天后到期。”

助手会选择你的发票模板，填入数据，通过 DocMake API 渲染 PDF，并提供文件路径。

示例提示词

• “为 Acme Corp 生成发票：10 小时咨询服务，每小时 100 EUR，14 天后到期。”
• “我的雇佣合同模板需要哪些字段？然后为 Maria Ionescu 填写模板，入职日期为 10 月 1 日，并另存为 DOCX。”
• “将 ~/Documents/quarterly-report.docx 导入为 DocMake 模板，然后显示找到的变量。”

设置

你需要一个 DocMake API 密钥。前往 app.docmake.io，在 Settings > API Keys 中创建密钥（免费方案即可使用）。

Claude Desktop

在 claude_desktop_config.json 中添加（Settings > Developer > Edit Config）：

{
  "mcpServers": {
    "docmake": {
      "command": "npx",
      "args": ["-y", "@docmake/mcp@latest"],
      "env": {
        "DOCMAKE_API_KEY": "dm_your_key_here"
      }
    }
  }
}

Claude Code

claude mcp add docmake --env DOCMAKE_API_KEY=dm_your_key_here -- npx -y @docmake/mcp@latest

Cursor / 其他 MCP 客户端

任何支持 stdio MCP 服务的客户端都可以使用相同的命令：npx -y @docmake/mcp@latest，并在环境中设置 DOCMAKE_API_KEY。

远程服务（无需安装）

DocMake 还通过可流式传输的 HTTP 提供相同的六种工具，因此支持远程 MCP 的客户端无需安装任何内容：

{
  "mcpServers": {
    "docmake": {
      "url": "https://app.docmake.io/mcp/v1",
      "headers": { "Authorization": "Bearer dm_your_key_here" }
    }
  }
}

与此软件包相比有两处不同。render_document 会返回一个短时有效的下载链接，而不是将文件写入你的设备；import_docx 接收的是文档的 base64 编码，而不是文件路径，因为服务运行在远程环境中，无法读取你的磁盘。其他一切（包括严格渲染）都相同。

配置

变量	必填	默认值	用途
DOCMAKE_API_KEY	是		来自 app.docmake.io 的 API 密钥，路径为 Settings > API Keys
DOCMAKE_OUTPUT_DIR	否	~/Downloads/DocMake	渲染后的文档保存位置
DOCMAKE_API_BASE	否	https://app.docmake.io/api/v1	API 基础 URL；可在可自托管的部署中覆盖

工具

工具	功能
list_templates	列出工作区中的模板，支持搜索和分页
get_template	获取模板的字段树：模板需要的所有变量，可直接映射到渲染数据
render_document	将模板渲染为 PDF 或 DOCX，并在本地保存文件
create_template	根据文档架构 JSON 创建新模板
import_docx	将本地 .docx 文件导入为新模板（远程服务使用 base64 编码）
get_usage	查看当前计费周期的方案、渲染配额和速率限制

该服务还会将你的模板作为 MCP 资源公开，并提供 generate-document 提示词，引导你完成渲染流程。

渲染方式

默认情况下，render_document 会严格执行：如果 data 中缺少任何模板变量的值，渲染就会失败，并返回缺失键的列表，这样助手就可以询问你所需的值，而不是生成不完整的文档。传入 strict: false，则会使用每个变量的备用文本进行渲染。

可以在模板编辑器中为变量声明默认值。具有默认值的变量永远不会被视为缺失：即使在严格模式下，只要不在 data 中提供该变量，也会渲染其默认值。get_template 会显示每个字段的 default（以及 example，这是仅用于预览、永远不会被渲染的示例）。

渲染后的文件会保存到 DOCMAKE_OUTPUT_DIR，且不会覆盖已有文件。

隐私政策

完整政策：https://docmake.io/privacy

此服务收集的内容。 此服务本身不会收集任何信息。它没有遥测或分析功能，也不会读取你的聊天记录、记忆或文件，除非你明确将某个 .docx 文件传递给 import_docx。

发送的内容及其去向。 每次工具调用都会通过 HTTPS 向 DocMake API（https://app.docmake.io/api/v1）发送请求，并使用你的 API 密钥进行身份验证。请求仅包含该调用所需的内容：模板 ID、你要求渲染的数据，或你要求导入的 .docx 文件。DocMake 会处理这些数据以渲染文档。

存储与保留。 你的模板和账户数据存储在 DocMake 工作区中，并会保留到你将其删除或关闭账户为止。渲染后的文档会保存到你自己的设备上的 DOCMAKE_OUTPUT_DIR 目录中（默认为 ~/Downloads/DocMake），且绝不会上传到其他地方。你的 API 密钥保留在自己的设备上：桌面扩展会将其保存在操作系统的钥匙串中，手动配置则会将其保存在 MCP 客户端的配置文件中。

与第三方共享。 渲染数据不会被出售，也不会与第三方共享，但 DocMake 为运行服务所需的子处理方除外。完整政策中列出了这些子处理方。

联系方式。 如有隐私相关问题、数据导出或删除请求，请联系 [email protected]。

链接

• DocMake，模板库和产品
• API 文档
• 控制面板
• 支持：[email protected]

许可证

MIT