FileToPDF

官方

將檔案(DOCX、XLSX、PPTX、圖片)、HTML 和 Markdown 轉換為像素完美的 PDF — 支援 npx stdio 或託管 Streamable HTTP,一鍵獲取免費 API 金鑰。

你可以用 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 — 將 Markdown 字串傳送給 convert_markdown,並可選擇樣式與版面控制。
  • 將生成的 PDF 儲存到磁碟 — 設定 FILETOPDF_OUTPUT_DIR 環境變數,或傳遞 save_path 以將 PDF 檔案寫入本機。

文件

FileToPDF MCP 伺服器

npm smithery badge Install MCP Server

一個用於 FileToPDFModel Context Protocol 伺服器。它讓任何 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公開網址將檔案(DOCX、XLSX、PPTX、圖片、HTML、MD、PDF…)轉換為 PDF。
convert_html透過 Chromium 將原始 HTML 字串(搭配可選的 CSS 與版面配置選項)渲染為像素級精確的 PDF。
convert_markdown將原始 Markdown 字串(搭配可選的 CSS 與版面配置選項)渲染為整潔的 PDF。

每個轉換工具都會回傳一個中繼資料摘要以及作為嵌入式 application/pdf 資源(base64)的 PDF,因此具備能力的客戶端可以儲存檔案。設定 FILETOPDF_OUTPUT_DIR 環境變數,或傳遞 save_path,也能將 PDF 寫入磁碟。

版面配置選項(landscapepaperWidth/Height、邊界、scalepdfa、密碼…)適用於 Pro、Scale 和免費試用方案;在 Starter/Basic 方案上會回傳升級錯誤。每次成功轉換消耗 1 點數;錯誤則免費。

快速入門(本機 / stdio)

Cursor — 一鍵安裝: 新增至 Cursor (然後將佔位符替換為您的金鑰)。

Claude Desktop / Cline / 任何 stdio 客戶端 — 新增至 MCP 設定 (claude_desktop_config.jsoncline_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: Add Server):

{
  "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 客戶端步驟的平台中的網址—— n8n(MCP Client Tool)、Make(MCP Client)、Zapier(MCP Client beta)、 Relay.app(Call MCP tool)、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,或從 gitignored 的 .env 讀取 API_KEY=

連結

授權條款

MIT