FileToPDF MCP Server

offiziell

Konvertiert Dateien (DOCX, XLSX, PPTX, Bilder), HTML und Markdown in pixelgenaue PDFs — npx stdio oder gehostetes Streamable HTTP, kostenloser API-Key mit einem Klick.

GitHub

Dokumentation

FileToPDF MCP-Server

Ein Model Context Protocol-Server für FileToPDF. Er ermöglicht jedem MCP-Client – Claude Desktop, Claude Code, Cursor, Cline, VS Code, ChatGPT, n8n, Make oder Ihrem eigenen Agenten – die Konvertierung von Dateien, HTML und Markdown in PDF mittels natürlicher Sprache: Rechnungen, Berichte, Dokumentationen, DOCX/XLSX/PPTX, Bilder, Webseiten und mehr.

Bringen Sie Ihren eigenen API-Schlüssel mit – erhalten Sie kostenlos einen, mit einem Klick, unter https://filetopdf.dev (10 kostenlose Konvertierungen, keine Anmeldung erforderlich).

Werkzeuge

Werkzeug	Funktion
`get_account`	API-Schlüssel prüfen und Tarif + verbleibende Credits anzeigen. Kostenlos, keine Credits verbraucht.
`convert_file`	Eine Datei von einer öffentlichen URL (DOCX, XLSX, PPTX, Bilder, HTML, MD, PDF…) in PDF konvertieren.
`convert_html`	Einen rohen HTML-String (mit optionalen CSS- + Layout-Optionen) über Chromium in ein pixelgenaues PDF rendern.
`convert_markdown`	Einen rohen Markdown-String (mit optionalen CSS- + Layout-Optionen) in ein sauberes PDF rendern.

Jedes Konvertierungswerkzeug liefert eine Metadaten-Zusammenfassung und das PDF als eingebettete application/pdf-Ressource (base64), sodass geeignete Clients die Datei speichern können. Setzen Sie die FILETOPDF_OUTPUT_DIR-Umgebungsvariable oder übergeben Sie save_path, um das PDF auch auf die Festplatte zu schreiben.

Layout-Optionen (landscape, paperWidth/Height, Ränder, scale, pdfa, Passwörter, …) sind in Pro, Scale und der kostenlosen Testphase verfügbar; bei Starter/Basic wird ein Upgrade-Fehler zurückgegeben. Jede erfolgreiche Konvertierung kostet 1 Credit; Fehler sind kostenlos.

Schnellstart (lokal / stdio)

Cursor – Installation mit einem Klick: Zu Cursor hinzufügen (dann den Platzhalter durch Ihren Schlüssel ersetzen).

Claude Desktop / Cline / jeder stdio-Client – zur MCP-Konfiguration hinzufügen (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 oder über MCP: Server hinzufügen):

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

Gehostet / Remote (Streamable HTTP) – keine Installation

Ein gehosteter Endpunkt ist unter https://api.filetopdf.dev/mcp verfügbar. Authentifizieren Sie sich mit Ihrem eigenen Schlüssel über den x-api-key-Header, einen Authorization: Bearer-Header oder einen ?apiKey=-Query-Parameter.

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

Dies ist auch die URL, die Sie in jede Plattform mit einem MCP-Client-Schritt einfügen können – n8n (MCP Client Tool), Make (MCP Client), Zapier (MCP Client Beta), Relay.app (MCP-Tool aufrufen), Flowise, Langflow, Dify, LibreChat, AnythingLLM oder Agent-Frameworks (OpenAI Agents SDK, LangChain, CrewAI, Vercel AI SDK).

Alternativ zum Selbst-Hosten:

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

Eine Dockerfile ist für Container-Hosting enthalten (Smithery, Fly, Render, Cloud Run).

Entwickeln & Testen

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

npm test liest FILETOPDF_API_KEY oder API_KEY= aus einer gitignorierten .env.

Lizenz

MIT