FileToPDF

官方

将文件（DOCX、XLSX、PPTX、图片）、HTML和Markdown转换为像素级完美的PDF——通过npx stdio或托管的Streamable HTTP，一键获取免费API密钥。

GitHub
2

你可以用 File To PDF MCP 做什么？

  • 检查账户状态和剩余额度 — 让助手调用 get_account 来验证您的 API 密钥、套餐等级和转换余额。
  • 将公开托管的文件转换为 PDF — 提供 DOCX、XLSX、PPTX、图片、HTML 或 MD 文件的 URL，并通过 convert_file 返回 PDF。
  • 将 HTML 字符串渲染为 PDF — 将原始 HTML（可附带 CSS 和布局选项）传递给 convert_html，以基于 Chromium 实现像素级精确输出。
  • 将 Markdown 转换为整洁的 PDF — 向 convert_markdown 发送 Markdown 字符串，并可选择添加样式和布局控制。
  • 将生成的 PDF 保存到本地磁盘 — 设置 FILETOPDF_OUTPUT_DIR 环境变量，或传递 save_path 参数，以将 PDF 文件写入本地。

文档

FileToPDF MCP 服务器

npm smithery badge Install MCP Server

一个用于 FileToPDF 的 模型上下文协议 服务器。它允许任何 MCP 客户端——Claude Desktop、Claude Code、Cursor、Cline、VS Code、ChatGPT、n8n、Make 或您自己的智能体——通过自然语言将文件、HTML 和 Markdown 转换为 PDF：发票、报告、文档、DOCX/XLSX/PPTX、图片、网页等。

自带 API 密钥——在 https://filetopdf.dev 免费一键获取（10 次免费转换，无需注册）。

工具

工具功能描述
get_account检查 API 密钥并显示套餐及剩余配额。免费，不消耗配额。
convert_file将来自公开 URL 的文件（DOCX、XLSX、PPTX、图片、HTML、MD、PDF 等）转换为 PDF。
convert_html将原始 HTML 字符串（可选 CSS + 布局选项）通过 Chromium 渲染为像素级精确的 PDF。
convert_markdown将原始 Markdown 字符串（可选 CSS + 布局选项）渲染为整洁的 PDF。

每个转换工具都会返回一个元数据摘要以及作为嵌入式 application/pdf 资源（base64）的 PDF，因此兼容的客户端可以保存文件。设置 FILETOPDF_OUTPUT_DIR 环境变量，或传递 save_path，也可以将 PDF 写入磁盘。

布局选项（landscape、paperWidth/Height、边距、scale、pdfa、密码等）在 Pro、Scale 和免费试用版中可用；在 Starter/Basic 套餐中会返回升级错误。每次成功转换消耗 1 个配额；错误不消耗配额。

快速开始（本地 / stdio）

Cursor——一键安装： 添加到 Cursor （然后将占位符替换为您的密钥）。

Claude Desktop / Cline / 任何 stdio 客户端——添加到 MCP 配置（claude_desktop_config.json、cline_mcp_settings.json 等）：

{
  "mcpServers": {
    "filetopdf": {
      "command": "npx",
      "args": ["-y", "filetopdf-mcp"],
      "env": { "FILETOPDF_API_KEY": "sk_live_YOUR_API_KEY" }
    }
  }
}

Claude Code：

claude mcp add filetopdf -e FILETOPDF_API_KEY=sk_live_YOUR_API_KEY -- npx -y filetopdf-mcp

VS Code（.vscode/mcp.json 或通过 MCP: 添加服务器）：

{
  "servers": {
    "filetopdf": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "filetopdf-mcp"],
      "env": { "FILETOPDF_API_KEY": "sk_live_YOUR_API_KEY" }
    }
  }
}

托管 / 远程（Streamable HTTP）——无需安装

托管端点位于 https://api.filetopdf.dev/mcp。通过 x-api-key 标头、Authorization: Bearer 标头或 ?apiKey= 查询参数使用您自己的密钥进行身份验证。

{
  "mcpServers": {
    "filetopdf": {
      "type": "streamable-http",
      "url": "https://api.filetopdf.dev/mcp",
      "headers": { "x-api-key": "sk_live_YOUR_API_KEY" }
    }
  }
}

这也是可以粘贴到任何带有 MCP 客户端步骤的平台中的 URL——n8n（MCP 客户端工具）、Make（MCP 客户端）、Zapier（MCP 客户端测试版）、Relay.app（调用 MCP 工具）、Flowise、Langflow、Dify、LibreChat、AnythingLLM 或智能体框架（OpenAI Agents SDK、LangChain、CrewAI、Vercel AI SDK）。

如需自行托管：

npm run build && npm run start:http   # listens on $PORT (default 8080) at /mcp

包含一个 Dockerfile 用于容器托管（Smithery、Fly、Render、Cloud Run）。

开发与测试

npm install
npm run build          # tsc -> dist/
npm test               # spawns the built stdio server, runs a live conversion

npm test 读取 FILETOPDF_API_KEY，或从 git 忽略的 .env 中读取 API_KEY=。

链接

许可证

MIT