| Komponente | Zweck |
|---|---|
| Claude Code | Plugin-Host |
| Python 3.10 oder neuer | Laufzeit des MCP-Servers (läuft in einer eigenen virtuellen Umgebung) |
| Pandoc | EPUB- und PDF-Export |
| xelatex | PDF-Export (der Export-Befehl ruft Pandoc mit --pdf-engine=xelatex auf) |
Calibre (ebook-convert) |
Nur für MOBI-Export, optional |
Ein eigener API-Key ist nicht nötig. Das Plugin arbeitet über den Claude-Zugang von Claude Code.
Die README des Projekts nennt diesen Weg:
claude plugin add storyforge
Das Repository bringt dafür ein Plugin-Manifest (.claude-plugin/plugin.json) und eine Marketplace-Datei (.claude-plugin/marketplace.json) mit. Das Manifest bindet die Skills aus skills/, den MCP-Server storyforge-mcp und drei Hooks ein.
Nach der Installation legt das Setup-Skill alles Weitere an:
/storyforge:setup
Das Skill arbeitet diese Schritte ab (die Nummern entsprechen denen im Skill):
python3, dann python, dann py -3, unter Windows zusätzlich bekannte Installationspfade).~/.storyforge/venv anlegen, falls sie fehlt.requirements.txt des Plugins installieren: mcp (Version 2.x), pyyaml, pymupdf, python-docx sowie einige Sicherheits-Mindestversionen für transitive Pakete.~/.storyforge/cache und ~/.storyforge/authors anlegen.~/.storyforge/config.yaml aus config/config.example.yaml kopieren, falls die Datei noch nicht existiert.pandoc --version) und bei Fehlen einen Installationshinweis geben.ebook-convert --version, nur für MOBI nötig).~/projekte/book-projects/projects anlegen, falls es fehlt.Schritt 9 legt immer
~/projekte/book-projects/projectsan, auch wenn du in der Config einen anderenpaths.content_rooteinträgst. Passe den Pfad danach in der Konfiguration an.
Das Setup-Skill ist auch die Reparatur-Funktion: Wenn der MCP-Server nicht antwortet, führe es erneut aus.
Die Datei .mcp.json des Plugins startet den Server storyforge-mcp über einen kleinen Wrapper, der das Python der virtuellen Umgebung aufruft.
| Plattform | Wrapper | Interpreter |
|---|---|---|
| Linux, macOS | bin/run-server |
~/.storyforge/venv/bin/python3 |
| Windows | bin/run-server.cmd |
%USERPROFILE%\.storyforge\venv\Scripts\python.exe |
Auch die drei Hooks laufen über diesen Wrapper. Ohne die virtuelle Umgebung unter ~/.storyforge/venv laufen weder Server noch Hooks.
python3 wird nicht gefundenAuf Windows brechen python3 und python manchmal ohne Ausgabe mit Exit-Code 49 ab, obwohl Python installiert ist. Das ist der Platzhalter des Microsoft Stores und keine fehlende Installation. Das Setup-Skill probiert deshalb zusätzlich py -3 und die üblichen Installationsverzeichnisse. Meldet es danach weiterhin, dass Python fehlt, installiere Python 3.10 oder neuer von python.org und aktiviere „Add python.exe to PATH“.
/storyforge:create-author Mein Name
/storyforge:new-book
/storyforge:help
/storyforge:create-author legt das Autorenprofil an, das jede Prosa-Entscheidung steuert./storyforge:new-book legt das Buchprojekt mit Verzeichnisgerüst an./storyforge:help zeigt alle Skills und den Workflow.Weiter geht es mit der Konfiguration und der Skills-Referenz.