@sheetrender/mcp

MCP-Server für SheetRender — geben Sie Ihrem KI-Assistenten die Möglichkeit, PDFs aus HTML-Vorlagen und Tabellendaten zu rendern.

Einrichtung

Holen Sie sich einen API-Schlüssel von sheetrender.com → Einstellungen → API-Schlüssel und fügen Sie ihn dann Ihrer MCP-Client-Konfiguration hinzu:

{
  "mcpServers": {
    "sheetrender": {
      "command": "npx",
      "args": ["-y", "@sheetrender/mcp"],
      "env": { "SHEETRENDER_API_KEY": "sr_live_..." }
    }
  }
}

SHEETRENDER_API_URL wird ebenfalls gelesen, standardmäßig https://sheetrender.com. Setzen Sie sie nur, um auf eine selbst gehostete oder Staging-Instanz zu verweisen.

Related MCP server: Dokmatiq DocGen

Tools

render_pdf

Rendert ein PDF aus dem von Ihnen bereitgestellten HTML.

Gibt den Pfad des gespeicherten PDFs und seine Größe zurück. Unter 512 KB wird es zusätzlich inline als base64-Ressource angehängt, sodass Clients, die Anhänge anzeigen, das Dokument selbst darstellen.

Es gelten zwei Server-Limits. HTML über 2 MB wird abgelehnt — gemessen sowohl an dem, was Sie senden, als auch an dem Dokument, nachdem data eingesetzt wurde. Eine Vorlage, die einen langen Datensatz expandiert, kann die Grenze also überschreiten, auch wenn das von Ihnen geschriebene Markup dies nicht tut. Und im kostenlosen Plan trägt jedes gerenderte PDF eine Fußzeile „Erstellt mit SheetRender" — von render_pdf und render_template gleichermaßen; kostenpflichtige Pläne nicht.

list_templates

Keine Argumente. Gibt den Namen, die ID und das Datum der letzten Aktualisierung jeder gespeicherten Vorlage zurück. Rufen Sie sie auf, um einen vom Benutzer erwähnten Vorlagennamen in die ID umzuwandeln, die die anderen Tools benötigen.

render_template

Rendert ein PDF aus einer bereits im Konto gespeicherten Vorlage.

Gleiche Rückgabe wie render_pdf.

create_batch_job

Stellt einen Hintergrundjob in die Warteschlange, der ein PDF pro Zeile eines bereits in das Projekt hochgeladenen Datensatzes rendert. Dieser Server kann keine Tabellenkalkulationen hochladen.

Gibt die Job-ID zurück, die mit get_job abgefragt werden kann. Beachten Sie, dass filename_template und group_by in der Vorlage bzw. im Projekt gespeichert werden, sodass sie auch die Standardwerte für spätere Läufe ändern.

Wenn der Server älter ist als der öffentliche Batch-Endpunkt, meldet das Tool, dass Batch-Jobs nicht verfügbar sind, anstatt auf unklare Weise zu scheitern.

get_job

Nimmt job_id entgegen. Gibt den Status, erledigte und fehlgeschlagene Zeilen sowie — sobald der Job succeeded, partial, failed oder cancelled erreicht — die ID und den Dateinamen jedes gerenderten Dokuments zurück. Die Dokumentliste bleibt leer, während der Job queued, retry_queued oder running ist. Diese Dokument-IDs sind es, die get_document entgegennimmt.

get_document

Nimmt document_id entgegen und lädt dieses einzelne gerenderte PDF herunter. Die IDs stammen von get_job bei einem abgeschlossenen Batch; es gibt keinen anderen Weg, eine zu erhalten. Gleiche Rückgabe wie render_pdf — Pfad, Größe und ein Inline-Blob unter 512 KB.

Für einen ganzen Batch sind das zusammengeführte PDF und die ZIP in der Web-App besser, als jedes Dokument einzeln abzurufen.

page_settings

Von beiden Render-Tools gemeinsam genutzt, jedes Feld optional:

{
  "page_size": "a4",
  "orientation": "portrait",
  "margins": { "top": 15, "right": 15, "bottom": 15, "left": 15 }
}

page_size ist kleingeschrieben — a3, a4, a5, letter, legal oder tabloid. Ränder sind einfache Zahlen in Millimetern, keine CSS-Längen.

Gerenderte PDFs werden in das temporäre Systemverzeichnis geschrieben. Fehler von der API — ein falscher Schlüssel, eine fehlende Vorlage, ein Rate-Limit — kommen als Tool-Fehler mit der eigenen Nachricht des Servers zurück.

Die öffentliche API erlaubt 120 Anfragen pro Minute pro API-Schlüssel. Darüber hinaus gibt sie 429 zurück und das Tool meldet, dass Sie ratenbegrenzt sind und es kurz darauf erneut versuchen sollten. Die Erstellung von Batch-Jobs wird separat und strenger gemessen.

Entwicklung

Kein Host-Node/npm erforderlich — scripts/dev.sh install, scripts/dev.sh deno task build.

MIT-lizenziert.