Storywright MCP

Ein Multi-Agenten-MCP-Server zum Schreiben von Büchern für Cursor, Claude Desktop, OpenCode oder jeden Host, der MCP über stdio unterstützt. Er kombiniert eine geschützte Kapitel-Pipeline (Autor → Lektor → konfigurierbare Drittanbieter-Durchläufe → Freigabe), JSON/Markdown-Projekte auf der Festplatte, Planung der Buch-Bibel, Kontinuitätsverfolgung, Manuskriptsuche, Marker-Scans, Kontext-Budgetierung für vorherige Kapitel sowie Export- und Diff-Hilfsmittel.

Der goldene Pfad (erste Stunde)

1. Installieren (aus diesem Repo):

   cd C:\Apps\claude_plugins\storywright-mcp
   uv sync --extra dev

2. API-Schlüssel festlegen (Benutzer-Umgebung oder MCP env-Block):

   • ANTHROPIC_API_KEY und/oder ANTHROPIC_AUTH_TOKEN — erforderlich für Autor/Lektor/Drittanbieter-Durchläufe (MiniMax verwendet normalerweise Bearer + ANTHROPIC_BASE_URL).

3. MCP in Cursor registrieren — erstellen oder bearbeiten Sie die mcp.json:

   Bereich	Pfad (Windows)
   Benutzer (alle Workspaces)	%USERPROFILE%\.cursor\mcp.json
   Nur dieses Repo	<repo>\.cursor\mcp.json

   Fügen Sie storywright in das bestehende "mcpServers"-Objekt ein, falls die Datei bereits andere Server enthält.

   Anthropic API-Schlüssel (Geheimnisse über Windows-Umgebung — Benutzer-Umgebungsvariablen festlegen, dann darauf verweisen):

   {
     "mcpServers": {
       "storywright": {
         "command": "uv",
         "args": ["run", "--directory", "C:/Apps/claude_plugins/storywright-mcp", "storywright-mcp"],
         "env": {
           "ANTHROPIC_API_KEY": "${env:ANTHROPIC_API_KEY}",
           "STORYWRIGHT_PROJECTS_ROOT": "C:/Users/you/Documents/writing",
           "STORYWRIGHT_ANTHROPIC_MODEL": "claude-sonnet-4-20250514"
         }
       }
     }
   }

   MiniMax (identisch mit Ihrer funktionierenden Shell — Bearer + Basis-URL + Modell):

   {
     "mcpServers": {
       "storywright": {
         "command": "uv",
         "args": ["run", "--directory", "C:/Apps/claude_plugins/storywright-mcp", "storywright-mcp"],
         "env": {
           "ANTHROPIC_BASE_URL": "https://api.minimax.io/anthropic",
           "ANTHROPIC_AUTH_TOKEN": "${env:ANTHROPIC_AUTH_TOKEN}",
           "STORYWRIGHT_ANTHROPIC_MODEL": "MiniMax-M2.7",
           "STORYWRIGHT_PROJECTS_ROOT": "C:/Users/you/Documents/writing"
         }
       }
     }
   }

   Legen Sie ANTHROPIC_AUTH_TOKEN in den Windows-Umgebungsvariablen (Benutzer) fest oder betten Sie den Wert nur vorübergehend ein, wenn Sie das Risiko in Kauf nehmen, dass er auf der Festplatte gespeichert wird. Bearbeiten Sie STORYWRIGHT_PROJECTS_ROOT, um festzulegen, wo book_projects/ gespeichert werden soll.

   MCP neu laden: Befehlspalette → “Cursor: Reload MCP Servers” (oder Cursor neu starten). uv muss im PATH des Terminals vorhanden sein, in dem Cursor die Server startet.

4. Führen Sie im Chat die Tools in der richtigen Reihenfolge aus:

   • check_environment — bestätigt Schlüssel + Modell + Version.

   • `create_book_project(project_name="mein-roman", book_title="Mein Roman", third_agents=["comedy","pacing"])

   • plan_book() … durch die Phasen (optional) oder direkt zu den Kapiteln springen.

   • add_chapter / add_character nach Bedarf.

   • get_pipeline_status — zeigt das genaue nächste Tool pro Kapitel an.

   • Pro Kapitel: start_chapter → run_writer_agent → run_editor_review → jedes run_third_agent → approve_chapter.

5. Wichtige Artefakte:

   • briefs/revision_queue.json — Notizen aus request_revision (der Autor-Prompt liest diese).

   • reports/chapter-NN-editor-meta.json — geparstes Urteil + Meta-Block vom Lektor.

   • manuscript/chapter-NN-draft.prev.md — Backup vor jedem Überschreiben durch den Autor; verwenden Sie diff_chapter.

   • EXPORT-manuscript.md — optionale Ausgabe von export_manuscript.

Related MCP server: creative-subagent-runner-mcp

Funktionen

• Strikter Workflow: Drittanbieter-Durchlauf erst nach dem Lektor; die Freigabe erfordert alle konfigurierten Drittanbieter-Agenten, sofern nicht force=true gesetzt ist.

• Pipeline-Hinweise: get_pipeline_status listet den nächsten Tool-Aufruf pro Kapitel auf.

• API-Bereitschaft: check_environment validiert Anthropic-Anmeldedaten (ANTHROPIC_API_KEY und/oder ANTHROPIC_AUTH_TOKEN), bevor Sie eine Sitzung starten.

• Budget für vorherige Prosa: Der Autor bezieht den Text der letzten freigegebenen Kapitel bis zu konfigurierbaren Wort-/Kapitel-Limits ein (spart Kontext im Vergleich zum Laden des gesamten Buches).

• Wiederholungsversuche: Vorübergehende Anthropic-Fehler (429/5xx, Timeouts) werden mit Backoff wiederholt (STORYWRIGHT_ANTHROPIC_MAX_RETRIES).

• Strukturierte Lektor-Meta: Lektor-Berichte sollten mit ---STORYWRIGHT_META_START--- … END--- enden; geparstes JSON neben dem Markdown-Bericht.

• Export / Diff: export_manuscript, diff_chapter (Entwurf vs .prev.md).

• Ressourcen: storywright://project/*, storywright://meta/version.

Installation

cd storywright-mcp
uv sync --extra dev

Umgebung

MiniMax (Anthropic-kompatibles Gateway)

Storywright verwendet das offizielle anthropic Python SDK, das ANTHROPIC_BASE_URL und ANTHROPIC_AUTH_TOKEN genauso liest wie Claude Code. Spiegeln Sie Ihre env-Einstellungen aus ~/.claude/settings.json in den Storywright MCP env-Block in Cursor (oder der Shell), zum Beispiel:

• ANTHROPIC_BASE_URL = https://api.minimax.io/anthropic

• ANTHROPIC_AUTH_TOKEN = Ihr MiniMax-Token (Bearer)

• STORYWRIGHT_ANTHROPIC_MODEL = MiniMax-M2.7 (oder die Modell-ID, die Ihr Anbieter erwartet)

Committen Sie keine API-Schlüssel; bevorzugen Sie OS-Umgebungsvariablen oder Cursor-Geheimnisse.

Ausführen (stdio)

uv run storywright-mcp
uv run python -m storywright_mcp

Claude Desktop / OpenCode

Verwenden Sie denselben command / args wie in Cursor, falls Ihre Anwendung MCP-stdio-Server unterstützt.

Typischer Workflow

1. create_book_project(..., third_agents=[...]) oder load_book_project("C:/absolut/.../book_projects/mein-buch")

2. plan_book() … (optional)

3. start_chapter(1) → run_writer_agent(1) → run_editor_review(1) → run_third_agent(1, …) → approve_chapter(1)

Verwenden Sie get_pipeline_status, wann immer Sie den Überblick verlieren.

CLI

uv run storywright-mcp agents           # list third-pass agents
uv run storywright-mcp smoke             # ping Anthropic/MiniMax (tiny token use)
uv run storywright-mcp smoke --with-book # temp folder + new project + chapter 1 writer (full pipeline chunk)

Namen wie run_editor_review(1) sind MCP-Tools (verwendet aus Cursor/Chat), keine Shell-Befehle. Von PowerShell aus können Sie dieselbe Logik nach load_book_project aufrufen:

uv run python -c "from storywright_mcp import workflow; workflow.load_book_project(r'C:/path/to/book_projects/your-book'); print(workflow.run_editor_review(1))"

MiniMax testen (oder einen beliebigen Anthropic-kompatiblen Proxy)

Legen Sie in PowerShell dieselben Variablen wie in ~/.claude/settings.json fest und führen Sie dann smoke aus dem Repo aus (Anmeldedaten bleiben nur in Ihrer Shell):

$env:ANTHROPIC_BASE_URL = "https://api.minimax.io/anthropic"
$env:ANTHROPIC_AUTH_TOKEN = "<your-token>"
$env:STORYWRIGHT_ANTHROPIC_MODEL = "MiniMax-M2.7"
cd C:\Apps\claude_plugins\storywright-mcp
uv run storywright-mcp smoke

Wenn Sie STORYWRIGHT_SMOKE_OK in der Ausgabe sehen, funktionieren Routing und Authentifizierung. Verwenden Sie smoke --with-book, um create_book_project → run_writer_agent mit Live-Inferenz zu bestätigen (kostet mehr Token; Dateien landen in einem temporären storywright-smoke-* Verzeichnis).

CI

GitHub Actions führt ruff + pytest bei Push/PR aus (.github/workflows/ci.yml).

Lizenz

MIT