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.
1 Installieren — wähle dein System
Windows Windows 10 · 11 · PowerShell 1 Einzeiler
- 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 | iexKein .NET nötig — alles ist in der Server-Datei gebündelt. Dein trainiertes OCR-Modell und ein gesetzter Arbeitsordner bleiben unangetastet.
- 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" - PrüfenLäuft alles?
Frag Claude nach der Version — das Werkzeug
mcp_versionantwortet. Kommt sie zurück, ist der Server verbunden.
Linux Debian · Ubuntu · Fedora · Arch (x64) · Claude Code 1 Einzeiler
- 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 denclaude mcp add-json-Befehl aus.curl -fsSL http://pdftools.kuonen.org/install-mcp.sh | shDie Binärdatei liegt unter
~/.local/share/Kuonen.PDFTools/mcp; dein trainiertes OCR-Modell liegt daneben und bleibt. - Claude CodeServer registrieren
claude mcp add kuonen-pdftools \ ~/.local/share/Kuonen.PDFTools/mcp/Kuonen.PDFTools.McpOCR (
ocr_folder) braucht Tesseract:sudo apt install tesseract-ocr tesseract-ocr-deu
macOS Apple Silicon & Intel · Homebrew 1 Einzeiler
- 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 - 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 - Claude CodeServer registrieren
claude mcp add kuonen-pdftools \ ~/.local/share/Kuonen.PDFTools/mcp/Kuonen.PDFTools.McpOCR (
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 perset_workdiränderbar. - Trägt
kuonen-pdftoolsnicht-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
deumitwählen). - Linux:
sudo apt install tesseract-ocr tesseract-ocr-deu - macOS:
brew install tesseract tesseract-lang
veraPDF + Java (goldener Weg)
- Java 8+ installieren: Windows Adoptium (Temurin) · Linux
sudo apt install default-jre-headless· macOSbrew install temurin. - veraPDF von verapdf.org/software laden und installieren (der Greenfield-Installer).
- Findet die Bibliothek beides nicht automatisch, die Pfade setzen:
KUONEN_PDFTOOLS_VERAPDF(Installationsordner von veraPDF) undKUONEN_PDFTOOLS_JAVA(Pfad zurjava-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_createPDF 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_pagesPDF 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_transparencyPDF optimieren 5
Verkleinern, Bilder neu komprimieren, fuer das Web linearisieren und ein PDF in einem Zug normalisieren.
optimize_pdfshrink_pdfrecompress_bilevellinearize_pdfnormalize_pdfPruefen & 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_pdfAuslesen 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_schemaErzeugen 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_imageKonvertierung 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_pclVisio 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_expectSchriften 9
Schriften auflisten, pruefen, reparieren, ersetzen, umwandeln, bearbeiten und aus einem PDF exportieren.
list_fontscheck_fontsfont_infofont_editconvert_fontexport_fontsrepair_fontsreplace_fontcheck_font_replacementNoten 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_ocrDruckvorstufe 8
Farben umrechnen, Farbprofile, Fotoblatt, Druckbedingungen, Rasterplatten, Kontrakt-Proof und JDF-Auftraege.
convert_colorslist_color_profilesexport_color_profilesphoto_sheetprint_condition_sheetscreen_platecontract_proofread_jdfFoto 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_galleryFormulare 7
Formularfelder auflisten, erkennen, ausfuellen und exportieren; XFA-Formulare; Berechnungen ausfuehren.
list_form_fieldsdetect_form_fieldsfill_formexport_form_datafill_xfarender_xfarun_form_calculationsOCR 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_resolveBarcodes 2
Barcodes und QR-Codes lesen und erzeugen.
read_barcodeswrite_barcodeBraille 3
Text als Blindenschrift-PDF oder Braille-Datei ausgeben und pruefen.
braille_pdfbraille_exportvalidate_brailleSicherheit & 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_signatureAkten & 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_searchSkripte 3
Dokument-JavaScript ausfuehren, HTML mit Skripten rendern, TypeScript uebersetzen.
run_document_scriptsrender_html_with_scriptstranspile_typescriptSystem 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