StoryForge: Installation
StoryForge installieren und einrichten: Voraussetzungen, Plugin-Installation, Setup-Skill, erstes Autorenprofil, Windows-Hinweise.
StoryForge: Installation
Voraussetzungen
| 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.
Plugin installieren
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.
Setup ausführen
Nach der Installation legt das Setup-Skill alles Weitere an:
/storyforge:setup
Das Skill arbeitet diese Schritte ab (die Nummern entsprechen denen im Skill):
- Plattform erkennen und einen funktionierenden Python-Interpreter finden (
python3, dannpython, dannpy -3, unter Windows zusätzlich bekannte Installationspfade). - Prüfen, ob Python 3.10 oder neuer vorhanden ist.
- Virtuelle Umgebung unter
~/.storyforge/venvanlegen, falls sie fehlt. - Abhängigkeiten aus
requirements.txtdes Plugins installieren:mcp(Version 2.x),pyyaml,pymupdf,python-docxsowie einige Sicherheits-Mindestversionen für transitive Pakete. - Die Verzeichnisse
~/.storyforge/cacheund~/.storyforge/authorsanlegen. ~/.storyforge/config.yamlausconfig/config.example.yamlkopieren, falls die Datei noch nicht existiert.- Pandoc prüfen (
pandoc --version) und bei Fehlen einen Installationshinweis geben. - Calibre prüfen (
ebook-convert --version, nur für MOBI nötig). - Den MCP-Import mit dem Python der virtuellen Umgebung testen.
- Das Verzeichnis
~/projekte/book-projects/projectsanlegen, falls es fehlt. - Den Status melden und den nächsten Schritt vorschlagen.
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.
Wie der MCP-Server gestartet wird
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.
Windows: python3 wird nicht gefunden
Auf 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“.
Erste Schritte nach der Installation
/storyforge:create-author Mein Name
/storyforge:new-book
/storyforge:help
/storyforge:create-authorlegt das Autorenprofil an, das jede Prosa-Entscheidung steuert./storyforge:new-booklegt das Buchprojekt mit Verzeichnisgerüst an./storyforge:helpzeigt alle Skills und den Workflow.
Weiter geht es mit der Konfiguration und der Skills-Referenz.