TemplateFoxPDF

TemplateFox MCP 服务

面向 TemplateFox PDF 生成 API 的 MCP（Model Context Protocol）服务。通过 Claude、Cursor 和 Windsurf 等 AI 助手直接从模板生成 PDF。

安装

Claude Desktop

将以下内容添加到 Claude Desktop 配置文件（macOS 上为 ~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "templatefox": {
      "command": "npx",
      "args": ["-y", "@templatefox/mcp-server"],
      "env": {
        "TEMPLATEFOX_API_KEY": "sk_your_api_key_here"
      }
    }
  }
}

Claude Code

claude mcp add templatefox -- npx -y @templatefox/mcp-server

然后在 shell 中设置环境变量 TEMPLATEFOX_API_KEY。

Cursor / Windsurf

在 MCP 服务配置中使用相同的 npx -y @templatefox/mcp-server 命令，并在环境中设置 TEMPLATEFOX_API_KEY。

全局安装（替代方案）

npm install -g @templatefox/mcp-server

然后使用 templatefox-mcp-server 作为命令，而不是 npx。

配置

环境变量	必填	描述
TEMPLATEFOX_API_KEY	是	你的 API 密钥（以 sk_ 开头）。请访问 app.templatefox.com/dashboard/api-keys 获取
TEMPLATEFOX_BASE_URL	否	覆盖 API 基础 URL（默认值：https://api.templatefox.com）

可用工具

工具	描述
generate_pdf	使用动态数据从模板生成 PDF（1 个额度）
generate_pdf_async	排队异步生成 PDF，可选使用 webhook（1 个额度）
get_pdf_job_status	检查异步 PDF 任务的状态
list_pdf_jobs	列出异步 PDF 生成任务
list_templates	列出所有可用模板
get_template_fields	获取模板的字段/变量
get_account_info	检查剩余额度和账户信息
list_transactions	查看额度交易历史

远程服务（HTTP）

MCP 服务还支持通过 Streamable HTTP 使用 HTTP 传输，适用于远程和云端部署。

通过 URL 连接

https://mcp-server-599407781746.us-central1.run.app/mcp

MCP 客户端必须通过 HTTP 标头传递 API 密钥：

Authorization: Bearer sk_your_api_key_here

或：

x-api-key: sk_your_api_key_here

自托管

通过设置环境变量 PORT，以 HTTP 模式运行服务：

PORT=8080 TEMPLATEFOX_API_KEY=sk_your_key node dist/index.js

或者使用 Docker：

docker build -t templatefox-mcp .
docker run -p 8080:8080 templatefox-mcp

MCP 端点位于 http://localhost:8080/mcp，健康检查端点位于 http://localhost:8080/health。

使用示例

配置完成后，你可以向 AI 助手提出以下请求：

“列出我的 PDF 模板，并使用 Invoice Template 生成一张发票，客户名称为‘John Doe’，金额为 150.00。”

助手将：

1. 调用 list_templates 查找可用模板
2. 调用 get_template_fields 确认所需字段
3. 使用模板 ID 和数据调用 generate_pdf
4. 返回 PDF 下载 URL

链接

• TemplateFox 文档
• API 参考
• 获取 API 密钥
• GitHub

许可证

MIT