Kuonen PDFTools · MCP-Server

Deine PDF-Werkzeugkiste, direkt in Claude.

Ein lokaler Server, der Claude das ganze Können der Bibliothek gibt — PDFs verbinden & schneiden, Text und Bilder auslesen, Formulare, Signaturen, Barcodes, Seiten zu PNG rendern, Scans per OCR durchsuchbar machen. Alles auf deinem Rechner, ohne Cloud.

Verbinden & schneiden Text & Tabellen Bilder & Rendern OCR & Formulare

1 Installieren — wähle dein System

Windows Windows 10 · 11 · PowerShell 1 Einzeiler
  1. InstallierenEin Befehl in PowerShell

    Lädt den Server, legt ihn lokal ab und trägt ihn behutsam in Claude Desktop ein (Backup zuerst — alle übrigen Einstellungen bleiben). Danach wird Claude Desktop automatisch neu gestartet.

    irm http://pdftools.kuonen.org/install-mcp.ps1 | iex

    Kein .NET nötig — alles ist in der Server-Datei gebündelt. Dein trainiertes OCR-Modell und ein gesetzter Arbeitsordner bleiben unangetastet.

  2. Claude CodeStatt Claude Desktop

    Nutzt du Claude Code? Nimm das Plugin (Gruppe „Als Plugin für Claude Code" weiter unten) — oder registriere den Server direkt:

    claude mcp add kuonen-pdftools "$env:LOCALAPPDATA\Kuonen.PDFTools\mcp\Kuonen.PDFTools.Mcp.exe"
  3. PrüfenLäuft alles?

    Frag Claude nach der Version — das Werkzeug mcp_version antwortet. Kommt sie zurück, ist der Server verbunden.

Linux Debian · Ubuntu · Fedora · Arch (x64) · Claude Code 1 Einzeiler
  1. InstallierenEin Befehl im Terminal

    Erkennt die Architektur (uname), lädt die passende self-contained Binärdatei (kein .NET-SDK nötig). Für Claude Code gibt der Installer den claude mcp add-json-Befehl aus.

    curl -fsSL http://pdftools.kuonen.org/install-mcp.sh | sh

    Die Binärdatei liegt unter ~/.local/share/Kuonen.PDFTools/mcp; dein trainiertes OCR-Modell liegt daneben und bleibt.

  2. Claude CodeServer registrieren
    claude mcp add kuonen-pdftools \
      ~/.local/share/Kuonen.PDFTools/mcp/Kuonen.PDFTools.Mcp

    OCR (ocr_folder) braucht Tesseract: sudo apt install tesseract-ocr tesseract-ocr-deu

macOS Apple Silicon & Intel · Homebrew 1 Einzeiler
  1. InstallierenEin Befehl im Terminal

    Erkennt Intel vs. Apple Silicon (uname), lädt die passende self-contained Binärdatei und trägt den Server behutsam in Claude Desktop ein (Backup zuerst).

    curl -fsSL http://pdftools.kuonen.org/install-mcp.sh | sh
  2. EinmaligGatekeeper freigeben

    Die Binärdatei ist nicht signiert. Über den Einzeiler läuft sie ohne Weiteres; lädst du sie über den Knopf, entferne einmalig die Quarantäne:

    xattr -dr com.apple.quarantine \
      ~/.local/share/Kuonen.PDFTools/mcp/Kuonen.PDFTools.Mcp
  3. Claude CodeServer registrieren
    claude mcp add kuonen-pdftools \
      ~/.local/share/Kuonen.PDFTools/mcp/Kuonen.PDFTools.Mcp

    OCR (ocr_folder) braucht Tesseract: brew install tesseract tesseract-lang

2 Andere Wege

Als Claude-Desktop-Erweiterung .mcpb — ein Doppelklick, alle Plattformen

Statt des Einzeilers kannst du die Erweiterung als .mcpb-Datei laden und per Doppelklick in Claude Desktop installieren (Einstellungen → Erweiterungen). Beim Installieren fragt Claude Desktop den Arbeitsordner ab; alle Werkzeuge sind darin sichtbar.

Der Server steckt im Bundle — kein separater Download. Es enthält die Server-Binärdatei für jede Plattform (Windows, macOS Intel/Apple Silicon, Linux); die Erweiterung wählt beim Start automatisch die passende.

Ein erneuter Doppelklick aktualisiert die Erweiterung; dein trainiertes OCR-Modell liegt getrennt und bleibt.

Als Plugin für Claude Code mit Skills & Slash-Befehl

Statt nur des MCP-Servers kannst du das ganze Plugin nehmen: es bindet den MCP-Server ein und bringt Skills (PDF-Werkzeuge, OCR, Akten-Ordnen) und den Slash-Befehl /pdf-buendel mit. Voraussetzung: der MCP-Server ist installiert (Einzeiler oben).

ZIP einmal entpacken. Darin liegt kuonen-pdftools.zip: dieses ZIP per Drag & Drop in Claude ziehen (Plugins → hochladen), fertig. Oder über den Marketplace im selben Ordner (.claude-plugin/ und kuonen-pdftools/), in Claude Code nacheinander:

/plugin marketplace add <entpackter-ordner>
/plugin install kuonen-pdftools@kuonen-pdftools

Alternativ direkt aus dem Repo, ohne Download: /plugin marketplace add kuomar/PDFTools

Gut zu wissen

Was der Einzeiler tut
  • Lädt die self-contained Server-Datei (kein .NET-SDK) an den Standardort.
  • Ein erneuter Lauf überschreibt nur das Programm — dein trainiertes OCR-Modell bleibt unangetastet.
  • Setzt einen Arbeitsordner (KUONEN_MCP_WORKDIR); relative Pfade lösen sich dagegen auf — jederzeit per set_workdir änderbar.
  • Trägt kuonen-pdftools nicht-destruktiv (mit Backup) in die Claude-Desktop-Config ein.
  • Beendet Claude Desktop und startet es automatisch neu, falls es lief — so greift der Eintrag sofort.
OCR & Voraussetzungen Tesseract nur für Scan-Durchsuchbarkeit

Nur ocr_folder/refine brauchen Tesseract — alles andere läuft ohne. Weitere Sprachen jederzeit per Chat über ocr_install_language.

  • Windows: Installer von UB Mannheim, deutsches Sprachpaket (deu) mitwählen und auf den PATH setzen.
  • Linux: sudo apt install tesseract-ocr tesseract-ocr-deu
  • macOS: brew install tesseract tesseract-lang

Pfade: absolute gelten immer; relative lösen sich gegen den Arbeitsordner auf (get_workdir/set_workdir).

Externe Werkzeuge optional — nur für OCR & den goldenen Validierungs-Weg

Alles Wichtige läuft ohne externe Werkzeuge — reine .NET-Bibliothek. Zwei Zusatz-Fähigkeiten werden freigeschaltet, wenn das jeweilige Werkzeug auf dem System vorhanden ist (rein optional):

  • Tesseract — für die Scan-Durchsuchbarkeit (ocr_folder/refine). Ohne Tesseract laufen alle anderen Werkzeuge normal.
  • veraPDF + Java — der goldene Weg der Standard-Prüfung (verapdf_validate): der unabhängige Industrie-Validator für PDF/A und PDF/UA. Ohne ihn geben die eingebauten Prüfer (check_pdfa/check_pdfua) die Antwort.

Tesseract (OCR)

  • Windows: Installer von UB Mannheim (deutsches Paket deu mitwählen).
  • Linux: sudo apt install tesseract-ocr tesseract-ocr-deu
  • macOS: brew install tesseract tesseract-lang

veraPDF + Java (goldener Weg)

  1. Java 8+ installieren: Windows Adoptium (Temurin) · Linux sudo apt install default-jre-headless · macOS brew install temurin.
  2. veraPDF von verapdf.org/software laden und installieren (der Greenfield-Installer).
  3. Findet die Bibliothek beides nicht automatisch, die Pfade setzen: KUONEN_PDFTOOLS_VERAPDF (Installations­ordner von veraPDF) und KUONEN_PDFTOOLS_JAVA (Pfad zur java-Datei).

Am einfachsten ohne Installation: das Docker-Image kuomar/kuonen.pdftools:tools bringt Tesseract, veraPDF + Java und Python samt der Testsuite-Orakel (pypdfium2, pdfminer.six, Pillow, python-docx, openpyxl, python-pptx, odfpy, EbookLib, pikepdf — siehe TOOLING.md) bereits mit — die „alles zusammen"-Variante (docker-compose.tools.yml). Das „blanke" Standard-Image bleibt ohne externe Werkzeuge.

Werkzeuge im Überblick

Alle 253 Werkzeuge, vollständig nach Themen — jede Gruppe mit + auf-/zuklappen. Frag Claude einfach, was du brauchst.

Dateien 27

Ordner und Dateien lesen, suchen, als Baum zeigen; Text bearbeiten, schreiben, verschieben, kopieren, loeschen (schreibend nur mit „Schreiben erlauben“); Zeichensatz und Zeilenenden; Archive.

list_directorydirectory_treesearch_filesread_fileread_multiple_filesread_media_filefile_infofile_signaturefile_permissionsfile_iconlist_allowed_directoriesdetect_encodingwrite_fileedit_filecreate_directorymove_pathcopy_pathdelete_pathset_attributesset_timestampsset_permissionsset_ownerconvert_encodingconvert_line_endingsarchive_listarchive_extractarchive_create
PDF zusammenstellen 11

PDFs, Bilder und Texte zu einem Dokument verbinden, Beilagen buendeln, Seiten herausschneiden, aufteilen, einfuegen, drehen und neu ordnen.

compose_pdfmerge_pdfassemble_bundleextract_pagessplit_pagessplit_by_sizesplit_by_bookmarksinsert_pagesinsert_page_breakrotate_pdforganize_pages
PDF bearbeiten 23

Text, Bilder und Metadaten aendern, Lesezeichen und Seitenrahmen, Wasserzeichen, Stempel, Seitenzahlen, Kopf-/Fusszeilen, Bates-Nummern, Links, Anmerkungen, Medien, Reduzieren.

edit_pdf_textedit_textedit_imageedit_metadataset_bookmarksset_page_boxwatermarkstamp_pdfadd_page_numbersheader_footerbates_numberadd_linkadd_actionadd_markupadd_measurementadd_rich_mediaadd_3d_annotationannotate_noteimport_commentsset_image_metadataliquid_layoutflatten_pdfflatten_transparency
PDF optimieren 5

Verkleinern, Bilder neu komprimieren, fuer das Web linearisieren und ein PDF in einem Zug normalisieren.

optimize_pdfshrink_pdfrecompress_bilevellinearize_pdfnormalize_pdf
Pruefen & PDF/A 11

Preflight samt Korrektur, zwei PDFs vergleichen, PDF/A und PDF/UA pruefen (auch mit veraPDF), nach PDF/A wandeln, Tags fuer Barrierefreiheit setzen.

preflightpreflight_fixcompare_pdfcheck_pdfacheck_pdfuaverapdf_validatepdfa_readinessconvert_to_pdfaconvert_folder_to_pdfacheck_folder_pdfaauto_tag_pdf
Auslesen 11

Text, Seiteninfos, Seitenbilder, eingebettete Bilder, Kommentare und Bild-Metadaten auslesen.

pdf_infoextract_textdocument_textrender_pagepdf_to_imagesexport_imagesvideo_to_framesexport_commentsimage_metadataextract_exe_iconkdoc_schema
Erzeugen 8

Neue PDFs aus Vorlagen, Text, HTML, Bildern, SVG oder Metafiles; Bilder in andere Formate wandeln.

generate_pdftext_to_pdfhtml_to_pdfimages_to_pdfsvg_to_pdfmetafile_to_pdfpdf_to_metafileconvert_image
Konvertierung 32

Office (Word, PowerPoint, Excel, OpenDocument), Markdown, LaTeX, RTF, HTML, InDesign, XSL-FO, PostScript/EPS, PCL und PWG von und nach PDF.

docx_to_pdfpdf_to_docxmd_to_pdfmd_to_docxlatex_to_pdfrtf_to_pdfpptx_to_pdfpdf_to_pptxxlsx_to_pdfpdf_to_xlsxhtml_to_docxhtml_to_xlsxpdf_to_odfpdf_to_odgidml_to_pdfpdf_to_idmlidml_to_kdockdoc_to_idmlpdf_to_kdocdocument_to_kdockdoc_to_documentkdoc_to_flipbookps_to_pdfeps_to_pdfps_to_docxpcl_to_pdfpwg_to_pdffo_to_pdffo_to_pngfo_to_tifffo_to_psfo_to_pcl
Visio 8

Visio-Zeichnungen nach PDF und zurueck, aus einem Datenmodell erzeugen, beschreiben und pruefen.

vsdx_to_pdfpdf_to_vsdxvsdx_to_kdockdoc_to_vsdxmodel_to_vsdxvsdx_checkvsdx_describevsdx_expect
Schriften 9

Schriften auflisten, pruefen, reparieren, ersetzen, umwandeln, bearbeiten und aus einem PDF exportieren.

list_fontscheck_fontsfont_infofont_editconvert_fontexport_fontsrepair_fontsreplace_fontcheck_font_replacement
Noten 12

MIDI und MusicXML nach PDF und untereinander wandeln, Stimmen umschreiben, Notenblaetter per OCR erkennen.

midi_to_pdfmusicxml_to_pdfmidi_to_musicxmlmusicxml_to_midimidi_to_kdocmusicxml_to_kdockdoc_to_musicxmlmusicxml_infokdoc_music_infotranscribe_partinstrumentsmusic_ocr
Druckvorstufe 8

Farben umrechnen, Farbprofile, Fotoblatt, Druckbedingungen, Rasterplatten, Kontrakt-Proof und JDF-Auftraege.

convert_colorslist_color_profilesexport_color_profilesphoto_sheetprint_condition_sheetscreen_platecontract_proofread_jdf
Foto 9

Fotos entwickeln wie in Lightroom, Rezepte und Vorgaben, Stapelverarbeitung, Katalog, Stichwoerter, Sammlungen, Fotobuch und Galerie.

photo_developphoto_recipephoto_presetphoto_batchphoto_catalogphoto_tagphoto_collectionphoto_bookphoto_gallery
Formulare 7

Formularfelder auflisten, erkennen, ausfuellen und exportieren; XFA-Formulare; Berechnungen ausfuehren.

list_form_fieldsdetect_form_fieldsfill_formexport_form_datafill_xfarender_xfarun_form_calculations
OCR 19

Gescannte PDFs durchsuchbar machen, unsichere Seiten finden, Text erkennen (auch per GPU/CRNN) und das eigene Modell trainieren.

ocr_pdfmake_searchableadd_text_layerocr_folderreview_ocrfind_hard_pagesgpu_ocrcrnn_ocrcrnn_searchablecrnn_train_pdfcrnn_model_infoocr_languagesocr_install_languageocr_add_wordsocr_train_documentocr_train_fontocr_model_infoocr_disputesocr_resolve
Barcodes 2

Barcodes und QR-Codes lesen und erzeugen.

read_barcodeswrite_barcode
Braille 3

Text als Blindenschrift-PDF oder Braille-Datei ausgeben und pruefen.

braille_pdfbraille_exportvalidate_braille
Sicherheit & Signaturen 14

Verschluesseln und entschluesseln (Passwort oder Zertifikat), bereinigen, schwaerzen, Passwort wiederherstellen; signieren, zertifizieren und Signaturen pruefen.

encrypt_pdfdecrypt_pdfencrypt_pdf_certdecrypt_pdf_certsanitize_pdfredact_pdfrecover_passwordsign_pdfcertify_pdfverify_signaturelist_signaturesexport_signaturesprepare_signatureembed_signature
Akten & E-Mail 15

Postfaecher (PST/OST) lesen und exportieren, Fallnummern finden, Akten beschreiben und ordnen, Duplikate finden, Ordner indizieren.

read_emailsexport_emailsfind_case_numberssearch_case_numberanalyze_documentsdescribe_documentsorganize_casesfind_duplicatesfolder_indexjob_startjob_statusjob_resultjob_cancelapply_sort_planfulltext_search
Skripte 3

Dokument-JavaScript ausfuehren, HTML mit Skripten rendern, TypeScript uebersetzen.

run_document_scriptsrender_html_with_scriptstranspile_typescript
System 16

Arbeitsordner, Fassung, Update und Lizenz; Programme starten und Dateien oeffnen; Rechner schlafen legen, abmelden, neu starten oder herunterfahren (opt-in, erhoehte Rechte).

set_workdirget_workdirmcp_versioncheck_updatelicense_statusget_licenseset_licenserun_processopen_pathsystem_power_statussystem_sleepsystem_hibernatesystem_logoffsystem_restartsystem_shutdownsystem_power_cancel
Läuft lokal auf Windows, Linux und macOS · spricht JSON-RPC über stdio · der Server ist self-contained (kein .NET nötig).