Storywright MCP

Servidor MCP de escritura de libros multi-agente para Cursor, Claude Desktop, OpenCode o cualquier host que utilice MCP sobre stdio. Combina un flujo de trabajo de capítulos supervisado (escritor → editor → terceras revisiones configurables → aprobación), proyectos en JSON/Markdown en disco, planificación de la "biblia" del libro, seguimiento de continuidad, búsqueda en el manuscrito, escaneo de marcadores, presupuesto de contexto de capítulos anteriores y herramientas de exportación/diferencias.

Camino ideal (primera hora)

1. Instalar (desde este repositorio):

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

2. Configurar la clave API (Variable de entorno de usuario o bloque env de MCP):

   • ANTHROPIC_API_KEY y/o ANTHROPIC_AUTH_TOKEN — requerido para el escritor/editor/tercera revisión (MiniMax suele usar Bearer + ANTHROPIC_BASE_URL).

3. Registrar MCP en Cursor — crear o editar mcp.json:

   Ámbito	Ruta (Windows)
   Usuario (todos los espacios de trabajo)	%USERPROFILE%\.cursor\mcp.json
   Solo este repositorio	<repo>\.cursor\mcp.json

   Fusiona storywright en el objeto "mcpServers" existente si el archivo ya tiene otros servidores.

   Clave API de Anthropic (secretos mediante variables de entorno de Windows — configura las variables de usuario y luego haz referencia a ellas):

   {
     "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 (igual que tu shell de trabajo — Bearer + URL base + modelo):

   {
     "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"
         }
       }
     }
   }

   Configura ANTHROPIC_AUTH_TOKEN en las Variables de entorno de Windows (Usuario), o incrusta temporalmente el valor solo si aceptas el riesgo de que permanezca en el disco. Edita STORYWRIGHT_PROJECTS_ROOT a la ubicación donde quieras que residan los book_projects/.

   Recargar MCP: Paleta de comandos → “Cursor: Reload MCP Servers” (o reinicia Cursor). uv debe estar en el PATH de la terminal donde Cursor inicia los servidores.

4. En el chat, ejecuta las herramientas en orden:

   • check_environment — confirma la clave, el modelo y la versión.

   • `create_book_project(project_name="mi-novela", book_title="Mi Novela", third_agents=["comedia","ritmo"])

   • plan_book() … a través de las fases (opcional), o salta directamente a los capítulos.

   • add_chapter / add_character según sea necesario.

   • get_pipeline_status — muestra la siguiente herramienta exacta por capítulo.

   • Por capítulo: start_chapter → run_writer_agent → run_editor_review → cada run_third_agent → approve_chapter.

5. Artefactos a conocer:

   • briefs/revision_queue.json — notas de request_revision (el prompt del escritor las lee).

   • reports/chapter-NN-editor-meta.json — veredicto analizado + bloque meta del editor.

   • manuscript/chapter-NN-draft.prev.md — copia de seguridad antes de cada sobrescritura del escritor; usa diff_chapter.

   • EXPORT-manuscript.md — salida opcional de export_manuscript.

Related MCP server: creative-subagent-runner-mcp

Características

• Flujo de trabajo estricto: La tercera revisión solo ocurre después del editor; la aprobación requiere todos los agentes de tercera revisión configurados a menos que force=true.

• Sugerencias de flujo: get_pipeline_status enumera la siguiente llamada a herramienta por capítulo.

• Preparación para API: check_environment valida las credenciales de Anthropic (ANTHROPIC_API_KEY y/o ANTHROPIC_AUTH_TOKEN) antes de consumir una sesión.

• Presupuesto de prosa anterior: El escritor incluye texto de capítulos aprobados recientes hasta límites configurables de palabras/capítulos (ahorra contexto en comparación con volcar todo el libro).

• Reintentos: Los errores transitorios de Anthropic (429/5xx, tiempos de espera) se reintentan con retroceso exponencial (STORYWRIGHT_ANTHROPIC_MAX_RETRIES).

• Meta del editor estructurada: Los informes del editor deben terminar con ---STORYWRIGHT_META_START--- … END---; JSON analizado junto al informe en markdown.

• Exportación / diferencias: export_manuscript, diff_chapter (borrador vs .prev.md).

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

Instalación

cd storywright-mcp
uv sync --extra dev

Entorno

MiniMax (puerta de enlace compatible con Anthropic)

Storywright utiliza el SDK oficial de Python anthropic, que lee ANTHROPIC_BASE_URL y ANTHROPIC_AUTH_TOKEN de la misma manera que Claude Code. Refleja tu env de ~/.claude/settings.json en el bloque env de Storywright MCP en Cursor (o shell), por ejemplo:

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

• ANTHROPIC_AUTH_TOKEN = tu token de MiniMax (Bearer)

• STORYWRIGHT_ANTHROPIC_MODEL = MiniMax-M2.7 (o cualquier ID de modelo que espere tu proveedor)

No confirmes claves API; prefiere variables de entorno del SO o secretos de Cursor.

Ejecución (stdio)

uv run storywright-mcp
uv run python -m storywright_mcp

Claude Desktop / OpenCode

Usa el mismo command / args que Cursor si tu aplicación admite servidores MCP stdio.

Flujo de trabajo típico

1. create_book_project(..., third_agents=[...]) o load_book_project("C:/absolute/.../book_projects/mi-libro")

2. plan_book() … (opcional)

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

Usa get_pipeline_status siempre que pierdas el hilo.

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)

Nombres como run_editor_review(1) son herramientas MCP (usadas desde Cursor/chat), no comandos de shell. Desde PowerShell puedes llamar a la misma lógica después de load_book_project:

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))"

Probar MiniMax (o cualquier proxy compatible con Anthropic)

Desde PowerShell, configura las mismas variables que en ~/.claude/settings.json, luego ejecuta smoke desde el repositorio (las credenciales permanecen solo en tu 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

Si ves STORYWRIGHT_SMOKE_OK en la salida, el enrutamiento y la autenticación funcionan. Usa smoke --with-book para confirmar create_book_project → run_writer_agent contra la inferencia en vivo (cuesta más tokens; los archivos se guardan en un directorio temporal storywright-smoke-*).

CI

GitHub Actions ejecuta ruff + pytest en push/PR (.github/workflows/ci.yml).

Licencia

MIT