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 伺服器
一個用於 FileToPDF 的 Model 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 寫入磁碟。
版面配置選項(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: 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=。
連結
- 網站與即時免費 API 金鑰:https://filetopdf.dev
- API 文件:https://filetopdf.dev/documentation
- 官方 MCP 註冊名稱:
dev.filetopdf/filetopdf-mcp