mcp-ikaos-story

Stdio-MCP-Server zum Erstellen und Ändern von iKAOS Story-Prototypinhalten mit Codex oder Claude Code.

Der MCP kommuniziert mit der authentifizierten iKAOS Story API. Benutzer müssen ikaos-content-studio-v2026 nicht klonen oder einen lokalen Repository-Pfad konfigurieren. Story-Inhalts-/Layout-JSON liegt in Supabase, während feste Workflow-Dokumente und Quellmetadaten hinter der API schreibgeschützt bleiben.

Grenzen

• get_story_context gibt die aktuelle Inhaltsrevision und den maßgeblichen docsLink zurück.

• save_story_content schreibt nur content_data; Quelle, Dokumente, Story-Identität und Produktionsmetadaten können nicht geändert werden.

• Jeder Inhalts-Schreibvorgang erfordert die exakte aktuelle Revision. Eine veraltete Bearbeitung gibt einen Konflikt zurück, anstatt neuere Inhalte zu überschreiben.

• Die Bildgenerierung liegt außerhalb des Rahmens. Designer können bereitgestellte Bilddateien über den df-sheet-Speicher hochladen, ersetzen, organisieren und löschen.

• Kein Supabase-Dienstschlüssel wird an MCP-Benutzer verteilt.

Installation

npm install
npm run build

Konfigurieren Sie die Story-API:

export IKAOS_STORY_API_URL=https://your-ikaos-preview.vercel.app
export IKAOS_STORY_API_TOKEN=your-project-scoped-api-token
export IKAOS_STORY_PREVIEW_URL=https://your-ikaos-preview.vercel.app

Bildwerkzeuge erfordern zusätzlich:

export DF_SHEET_URL=https://your-df-sheet.vercel.app
export DF_SHEET_PROJECT_ID=your-project-uuid
export DF_SHEET_ACCESS_TOKEN=your-df-login-review-access-token

IKAOS_STORY_PREVIEW_URL ist optional und standardmäßig auf http://localhost:3000 gesetzt. DF_SHEET_ACCESS_TOKEN ist derzeit ein kurzlebiges df-login-Review-Zugriffstoken. Committen Sie niemals ein Token.

Codex

codex mcp add ikaos-story \
  --env IKAOS_STORY_API_URL=https://your-ikaos-preview.vercel.app \
  --env IKAOS_STORY_API_TOKEN=your-project-scoped-api-token \
  --env IKAOS_STORY_PREVIEW_URL=https://your-ikaos-preview.vercel.app \
  -- node /absolute/path/to/mcp-ikaos-story/dist/src/index.js

Fügen Sie die drei DF_SHEET_*-Umgebungsvariablen zu demselben Befehl hinzu, wenn Bildwerkzeuge benötigt werden. Überprüfen Sie mit codex mcp list oder /mcp.

Claude Code

claude mcp add --transport stdio \
  --env IKAOS_STORY_API_URL=https://your-ikaos-preview.vercel.app \
  --env IKAOS_STORY_API_TOKEN=your-project-scoped-api-token \
  --env IKAOS_STORY_PREVIEW_URL=https://your-ikaos-preview.vercel.app \
  ikaos-story -- node /absolute/path/to/mcp-ikaos-story/dist/src/index.js

Fügen Sie die drei DF_SHEET_*-Umgebungsvariablen hinzu, wenn Bildwerkzeuge benötigt werden. Überprüfen Sie mit claude mcp list oder /mcp.

Werkzeuge

Inhaltsworkflow

1. Rufen Sie get_story_context auf.

2. Öffnen Sie docsLink und lesen Sie die erforderlichen festen Regeln mit get_story_rules.

3. Ändern Sie ausschließlich das zurückgegebene Inhalts-/Layout-Objekt currentData.data.

4. Rufen Sie save_story_content mit der unveränderten Story-ID und currentData.revision auf. Verwenden Sie null nur, wenn die Story noch keinen Inhalt hat.

5. Rufen Sie validate_story auf und prüfen Sie anschließend die zurückgegebene Vorschau-URL bei 390px und 1280px.

Wenn ein anderer Client zuerst gespeichert hat, rufen Sie den neuesten Kontext ab und führen Sie den Merge bewusst durch. Wiederholen Sie den Vorgang nicht mit einer ersetzten Revision, ohne die neueren Inhalte zu prüfen.

Bildworkflow

1. Wählen Sie eine gültige imagePromptPackages[].inputBrief.slotId aus dem Story-Inhalt.

2. Rufen Sie upload_story_image mit einem absoluten lokalen Bildpfad auf.

3. Verwenden Sie die zurückgegebene imageUrl im Story-Inhalt und speichern Sie diesen mit save_story_content.

4. Rufen Sie update_story_image auf, um Metadaten zu ändern oder die Datei zu ersetzen. Beim Ersetzen wird zuerst hochgeladen; die alte Datei wird erst nach erfolgreichem Upload gelöscht.

5. Rufen Sie delete_story_image erst auf, nachdem Sie die Bild-ID bestätigt haben. Das Löschen entfernt das R2-Objekt und kann von diesem MCP nicht wiederhergestellt werden.

Lassen Sie viewport für eine einzige responsive Quelle weg. Übergeben Sie dasselbe Viewport-Objekt an list, update und delete, wenn Sie separate Mobil- oder Desktop-Dateien verwenden.