pdfcraft-mcp

Alle Skills

Zweck

Öffnet, liest, schwärzt, bereinigt und bündelt PDFs über den MCP-Server von PdfCraft. Getestet mit 0.9.0 (Schwärzen, Doku-Pakete). Die Anweisungen für den Agenten stehen in SKILL.md (clientneutral).

Voraussetzungen

PdfCraft über den ArtCraft-Launcher (C:\Program Files\PdfCraft\pdfcraft-cli.exe, im MSI enthalten, nicht auf PATH)
Claude Desktop oder Cursor (siehe unten)
Die Erweiterung bzw. das Plugin sowie dieses Skill-ZIP

Cursor: siehe Wurzel-README und docs/CURSOR.md.

Installation (Claude Desktop)

Schritt-für-Schritt: docs/INSTALLATION.md. Kurz:

pdfcraft-mcp-v0.1.0.mcpb und pdfcraft-mcp-v0.1.0.zip aus dem Release laden.
Die .mcpb doppelklicken (oder über Einstellungen → Erweiterungen installieren).
Lese-Ordner weit: Dokumente (${HOME}/Documents). Schreib-Ordner eng und darin: Dokumente\Claude. PdfCraft lehnt es ab, eine selbst geschriebene Datei wieder zu öffnen, wenn der Schreib-Ordner außerhalb des Lese-Ordners liegt.
Unter Einstellungen → Erweiterungen prüfen, dass PdfCraft for Claude eingeschaltet ist.
Skill-ZIP hochladen: „+“ → „Skill erstellen“ → „Skill hochladen“.
Claude komplett beenden (auch Taskleiste) und neu starten. Neuen Chat öffnen.

Umsteigen von der manuellen Config: Eintrag pdfcraft unter mcpServers vor der Installation der Erweiterung entfernen (vorher Sicherungskopie).

Ordner

	Standard
Lesen	`${HOME}/Documents`
Schreiben	`${HOME}/Documents/Claude`

Der Server startet mit --compact. Ohne die Option liefert er 171 Werkzeuge mit etwa 176 KB Beschreibung. Mit ihr sind es 17 Kernwerkzeuge plus tool_search und tool_call. Dieselbe Option steht im Cursor-Plugin, weil Cursor die Zahl der aktiven Werkzeuge begrenzt (siehe docs/CURSOR.md).

Freigaben

In Claude bei doc_open, doc_save und tool_call auf „Immer fragen“ lassen, wenn du Pfade und Schwärzungen mitkontrollieren willst. redact_apply und doc_remove_hidden ändern die Datei endgültig.

Enthaltene Software

Die Erweiterung steuert PdfCraft (MIT oder Apache-2.0) aus dem ArtCraft-Launcher; die CLI wird nicht mitgeliefert. Lizenztexte liegen in der .mcpb unter LICENSES/. Das Icon ist die App-Kachel aus assets/app-icon/ (512×512, ebenfalls MIT oder Apache-2.0).

Test

Neuen Chat öffnen. Ein Test-PDF schwärzen lassen und doc_audit_redactions ausführen (Ergebnis count: 0). Die Werkzeuge heißen mit Präfix …PdfCraft_for_Claude….

Fehlen die Tools: Erweiterung eingeschaltet? CLI unter C:\Program Files\PdfCraft\pdfcraft-cli.exe? Neu starten, neuer Chat.

Stolpersteine

Speichern oder erneutes Öffnen mit „path rejected“: Ziel lag außerhalb des erlaubten Ordners, oder der Schreib-Ordner liegt nicht im Lese-Ordner. Einstellungen → Erweiterungen → PdfCraft for Claude.
Erweiterungen sind nicht signiert; nur installieren, wenn du der Quelle vertraust.

Deinstallation/Update

Einstellungen → Erweiterungen → entfernen; Skill löschen. Update: neue .mcpb und Skill-ZIP, ersetzen lassen, neu starten.

Alternative: manuell (für Entwickler)

Statt der Erweiterung den MCP-Server in claude_desktop_config.json eintragen. Stolpersteine: MCP unter Windows einrichten.

Claude-Installer: %APPDATA%\Claude\claude_desktop_config.json
Microsoft-Store-App: %LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "pdfcraft": {
      "command": "C:\\Program Files\\PdfCraft\\pdfcraft-cli.exe",
      "args": [
        "mcp",
        "--compact",
        "--automation-read-root", "C:\\Pfad\\zu\\Dokumente",
        "--automation-write-root", "C:\\Pfad\\zu\\Dokumente\\Claude"
      ]
    }
  }
}

--compact nicht weglassen. Beide Ordner setzen; der Schreib-Ordner muss im Lese-Ordner liegen.

Änderungen

CHANGELOG.md

4.2 KiB Raw Blame History Unescape Escape