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

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
```
Skript ansehen Server-EXE laden

Kein .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_version antwortet. 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 den claude mcp add-json-Befehl aus.
```
curl -fsSL http://pdftools.kuonen.org/install-mcp.sh | sh
```
Skript ansehen Linux (x64) laden

Die 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.Mcp
```
OCR (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
```
macOS Apple Silicon macOS Intel
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.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.

Erweiterung (.mcpb) laden

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).

Plugin-ZIP laden

ZIP einmal entpacken — der Ordner enthält direkt .claude-plugin/ und kuonen-pdftools/ —, dann 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)

Java 8+ installieren: Windows Adoptium (Temurin) · Linux sudo apt install default-jre-headless · macOS brew 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) 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 209 Werkzeuge, vollständig nach Themen — jede Gruppe mit + auf-/zuklappen. Frag Claude einfach, was du brauchst.

Verbinden & bearbeiten 40

PDFs zusammenfuegen, schneiden, drehen, wasserzeichnen, stempeln, nummerieren, Metadaten/Text/Anmerkungen bearbeiten.

merge_pdfextract_pagessplit_pagessplit_by_sizesplit_by_bookmarksinsert_pagesinsert_page_breakrotate_pdforganize_pagesflatten_pdfflatten_transparencyoptimize_pdfshrink_pdfrecompress_bilevellinearize_pdfedit_metadataset_bookmarksset_page_boxwatermarkstamp_pdfadd_page_numbersheader_footerbates_numberedit_pdf_textedit_textedit_imageadd_linkadd_actionadd_markupadd_measurementadd_rich_mediaadd_3d_annotationannotate_noteassemble_bundlecompare_pdfimport_commentsnormalize_pdfpreflight_fixset_image_metadataliquid_layout

Erzeugen 19

Neue PDFs aus Text/HTML/SVG/Bildern, Fotoblatt, Barcodes, Blindenschrift und Druckvorstufe (RIP/Proof/JDF).

generate_pdfhtml_to_pdfsvg_to_pdfmetafile_to_pdfpdf_to_metafileconvert_imageimage_metadataextract_exe_icontext_to_pdfimages_to_pdfcompose_pdfphoto_sheetprint_condition_sheetscreen_plateread_jdfcontract_proofbraille_pdfbraille_exportvalidate_braille

Konvertierung (Office · Web · E-Book · Druck) 41

Word/Excel/PowerPoint/InDesign/Markdown/HTML/PostScript in PDF und zurueck.

docx_to_pdfmd_to_pdflatex_to_pdfmd_to_docxpdf_to_docxpdf_to_odfpdf_to_odgidml_to_pdfpdf_to_idmlvsdx_to_pdfpdf_to_vsdxkdoc_to_idmlidml_to_kdocvsdx_to_kdockdoc_to_vsdxpptx_to_pdfpdf_to_pptxxlsx_to_pdfhtml_to_docxhtml_to_xlsxpdf_to_xlsxfo_to_pdffo_to_pngfo_to_tifffo_to_psfo_to_pclps_to_docxpdf_to_kdocdocument_to_kdockdoc_to_documentps_to_pdfeps_to_pdfrtf_to_pdfpcl_to_pdfpwg_to_pdfconvert_colorsconvert_encodingconvert_line_endingsmidi_to_pdfmusicxml_to_pdfmidi_to_musicxml

Inhaltsauszug & Schriften 19

Text/Bilder/Kommentare/Schriften auslesen, Seiten rendern, Preflight, Schriften pruefen/reparieren.

extract_textdetect_encodingdocument_textpdf_inforender_pagepdf_to_imagesexport_imagesexport_commentsexport_fontslist_fontscheck_fontsrepair_fontsreplace_fontconvert_fontfont_infofont_editmusicxml_infocheck_font_replacementpreflight

Archive 3

Archive auflisten, auspacken und packen — ZIP, TAR, GZip, BZIP2 und die Ketten .tar.gz/.tar.bz2. Erkannt wird an der Signatur, nicht an der Endung.

archive_listarchive_extractarchive_create

Formulare 7

AcroForm/XFA lesen, befuellen, Berechnungen, Daten exportieren.

list_form_fieldsdetect_form_fieldsfill_formexport_form_datafill_xfarender_xfarun_form_calculations

Sicherheit 7

Verschluesseln/entschluesseln (Passwort/Zertifikat), bereinigen, schwaerzen, Passwort-Wiederherstellung.

encrypt_pdfdecrypt_pdfencrypt_pdf_certdecrypt_pdf_certsanitize_pdfredact_pdfrecover_password

Signaturen 7

Signieren, zertifizieren, pruefen, exportieren, aufgeschobenes/externes Signieren (HSM).

sign_pdfverify_signaturecertify_pdflist_signaturesexport_signaturesprepare_signatureembed_signature

Barcodes 2

Erzeugen (QR/DataMatrix/Aztec/PDF417/Code 128/39/93/EAN/UPC/MaxiCode/Han Xin/DotCode) und lesen.

read_barcodeswrite_barcode

Standards & Farbe (PDF/A · Barrierefreiheit) 10

PDF/A + PDF/UA pruefen/umwandeln, goldene veraPDF-Validierung, Farbprofile.

check_pdfacheck_pdfuaverapdf_validateconvert_to_pdfaconvert_folder_to_pdfacheck_folder_pdfapdfa_readinesslist_color_profilesexport_color_profilesauto_tag_pdf

OCR & Training 17

Scans durchsuchbar machen (klassisch + GPU + CRNN), eigenes Modell trainieren, Sprachen nachladen.

ocr_pdfgpu_ocrmake_searchableadd_text_layerocr_folderocr_languagesocr_install_languageocr_add_wordsocr_train_documentocr_train_fontocr_model_inforeview_ocrfind_hard_pagescrnn_train_pdfcrnn_ocrcrnn_searchablecrnn_model_info

Gerichtsakten & Dateien 9

Fallnummern, nach Fall ordnen, beschreiben, Duplikate, Ordner-Index, Outlook-Postfaecher.

read_emailsexport_emailsfind_duplicatesfolder_indexfind_case_numberssearch_case_numberanalyze_documentsorganize_casesdescribe_documents

Skripting 3

TypeScript→JS, Dokument-/Formular-Skripte, HTML mit Skripten rendern.

transpile_typescriptrun_document_scriptsrender_html_with_scripts

Dateisystem, Programme & System (opt-in) 25

Arbeitsordner/Lizenz/Update; Dateien und Berechtigungen lesen — und opt-in schreiben/verschieben/loeschen, Rechte und Besitzer aendern (nur mit erhoehten Rechten) sowie Programme ausfuehren.

set_workdirget_workdirlicense_statusget_licenseset_licensemcp_versioncheck_updatelist_directorysearch_filesread_filefile_infofile_signaturefile_permissionsfile_iconwrite_filecreate_directorymove_pathcopy_pathdelete_pathset_attributesset_timestampsset_permissionsset_ownerrun_processopen_path