FileToPDF MCP server 是一个 Model Context Protocol（MCP）服务器，用于将文件、HTML 和 Markdown 转换为 PDF。它面向任何支持 MCP 的客户端，包括 Claude Desktop、Claude Code、Cursor、Cline、VS Code、ChatGPT、n8n、Make，以及用户自建的智能体。用户可以通过自然语言发起转换，例如发票、报告、文档、DOCX/XLSX/PPTX、图片、网页等。
主要能力：
- 支持将 DOCX、XLSX、PPTX、图片、HTML、Markdown 等转换为 PDF。
- 每次转换返回元数据摘要，并将 PDF 作为嵌入的 application/pdf 资源（base64）返回，具备相应能力的客户端可保存该文件。
- 可通过设置 FILETOPDF_OUTPUT_DIR 环境变量，或传递 save_path 参数，将 PDF 同时写入磁盘。
- 布局选项（landscape、paperWidth/Height、margins、scale、pdfa、passwords 等）在 Pro、Scale 和免费试用版中可用；在 Starter/Basic 版本中会返回升级错误。
- 每次成功转换消耗 1 个 credit，错误不扣费。
使用方式：
- 需要自备 API 密钥，可在 https://filetopdf.dev 一键免费获取（10 次免费转换，无需注册）。
- 本地/stdio 快速开始：
- Cursor：一键安装（Add to Cursor），然后将占位符替换为你的密钥。
- Claude Desktop / Cline / 任意 stdio 客户端：添加到 MCP 配置（claude_desktop_config.json、cline_mcp_settings.json 等）。
- VS Code：在 .vscode/mcp.json 中配置，或通过 MCP: Add Server 添加。
- 托管/远程（Streamable HTTP）无需安装：托管端点为 https://api.filetopdf.dev/mcp。通过 x-api-key 请求头、Authorization: Bearer 请求头或 ?apiKey= 查询参数使用自己的密钥进行认证。该 URL 也可粘贴到任何带 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）。
- 自托管：仓库包含 Dockerfile，可用于容器托管（Smithery、Fly、Render、Cloud Run）。
- 测试：npm test 会读取 FILETOPDF_API_KEY，或从被 gitignore 的 .env 中读取 API_KEY=。
适用场景：
- 在 MCP 客户端或智能体工作流中，通过自然语言将各类文档、图片、网页、HTML、Markdown 转换为 PDF。
- 自动化平台（如 n8n、Make、Zapier）中集成 PDF 转换步骤。
- 需要将转换结果保存到磁盘或作为嵌入资源返回的客户端。
限制：
- 需要自备 FileToPDF API 密钥。
- 布局选项仅在 Pro、Scale 和免费试用版中可用，Starter/Basic 会返回升级错误。
- 每次成功转换消耗 1 个 credit，错误免费。
- 免费试用提供 10 次免费转换，无需注册。
更多信息：
- 官网与免费 API 密钥：https://filetopdf.dev
- API 文档：https://filetopdf.dev/documentation
- 官方 MCP 注册名称：dev.filetopdf/filetopdf-mcp
