screenplaywriter-mcp

ScreenplayWriter MCP

Un servidor MCP para leer, escribir y analizar guiones en formato Fountain. Analiza guiones en datos estructurados, consulta estadísticas de personajes, genera desgloses de producción y escribe sintaxis Fountain adecuada.

Qué hace

Analiza archivos Fountain en un AST consultable. Edita escenas preservando el formato. Genera informes de personajes y desgloses de producción. Escribe nuevos guiones en formato profesional de la industria.

Herramientas

• parse_screenplay. Analiza texto Fountain en un AST estructurado.
• load_screenplay_file. Carga un archivo .fountain desde el disco.
• write_screenplay. Escribe un nuevo guion en formato Fountain en el disco.
• get_scene. Obtiene una escena específica por número.
• edit_scene. Reemplaza una escena y guarda en el disco.
• add_scene. Inserta una escena en una posición y guarda en el disco.
• remove_scene. Elimina una escena y guarda en el disco.
• character_report. Estadísticas por personaje que incluyen escenas, número de diálogos y recuento de palabras.
• scene_breakdown. Desglose de producción por escena con ubicaciones, personajes y recuento de líneas.
• runtime_estimate. Total de páginas, minutos, división día/noche, división interior/exterior.
• export_fountain. Guarda el guion almacenado de nuevo en un archivo .fountain.

Instalación

npx screenplaywriter-mcp

Configuración de Claude Desktop

Añade esto a tu claude_desktop_config.json:

{
  "mcpServers": {
    "screenplaywriter": {
      "command": "node",
      "args": ["/absolute/path/to/screenplaywriter-mcp/dist/index.js"]
    }
  }
}

O usa npx:

{
  "mcpServers": {
    "screenplaywriter": {
      "command": "npx",
      "args": ["-y", "screenplaywriter-mcp"]
    }
  }
}

Ejemplos de uso

Pregunta a Claude:

"Escribe un guion de tres escenas sobre un detective que descubre que el arma homicida es un teclado"

"Analiza mi guion y dame un informe de personajes"

"¿Cuántas escenas de día frente a escenas de noche tengo?"

"Añade una nueva escena después de la escena 3 donde el protagonista se enfrenta al villano"

"Genera un desglose de producción para mi guion"

"¿Cuál es el tiempo de duración estimado?"

Formato Fountain

Fountain es un formato de texto plano para guiones. Ejemplo:

FADE IN:

INT. COFFEE SHOP - DAY

JOHN (30s, tired programmer) stares at his laptop.

JOHN
This code does not work.

SARAH slides into the seat across from him.

SARAH
Have you tried turning it off and on again?

FADE OUT.

El servidor entiende todos los elementos estándar de Fountain. Encabezados de escena, indicaciones de personaje, diálogos, acotaciones, transiciones, líneas de acción, encabezados de sección y notas.

Estimación de duración

El servidor estima la duración según la regla estándar de que 1 página equivale a 1 minuto de tiempo en pantalla. El recuento de páginas se calcula a partir de las líneas de acción y diálogo.

Licencia

MIT