screenplaywriter-mcp

ScreenplayWriter MCP

Um servidor MCP para ler, escrever e analisar roteiros no formato Fountain. Analise roteiros em dados estruturados, consulte estatísticas de personagens, gere detalhamentos de produção e escreva sintaxe Fountain correta.

O que ele faz

Analisa arquivos Fountain em uma AST consultável. Edite cenas preservando a formatação. Gere relatórios de personagens e detalhamentos de produção. Escreva novos roteiros no formato profissional padrão da indústria.

Ferramentas

• parse_screenplay. Analise texto Fountain em uma AST estruturada.
• load_screenplay_file. Carregue um arquivo .fountain do disco.
• write_screenplay. Escreva um novo roteiro em formato Fountain no disco.
• get_scene. Obtenha uma cena específica pelo número.
• edit_scene. Substitua uma cena e salve no disco.
• add_scene. Insira uma cena em uma posição e salve no disco.
• remove_scene. Exclua uma cena e salve no disco.
• character_report. Estatísticas por personagem, incluindo cenas, contagem de falas e contagem de palavras.
• scene_breakdown. Detalhamento de produção por cena, com locações, personagens e contagem de linhas.
• runtime_estimate. Total de páginas, minutos, divisão dia ou noite, divisão interior ou exterior.
• export_fountain. Salve o roteiro armazenado de volta em um arquivo .fountain.

Instalação

npx screenplaywriter-mcp

Configuração do Claude Desktop

Adicione isto ao seu claude_desktop_config.json:

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

Ou use npx:

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

Exemplo de uso

Pergunte ao Claude:

"Escreva um roteiro de três cenas sobre um detetive que descobre que a arma do crime é um teclado"

"Analise meu roteiro e me dê um relatório de personagens"

"Quantas cenas de dia versus cenas de noite eu tenho?"

"Adicione uma nova cena após a cena 3 em que o protagonista confronta o vilão"

"Gere um detalhamento de produção para o meu roteiro"

"Qual a duração estimada?"

Formato Fountain

Fountain é um formato de texto simples para roteiros. Exemplo:

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.

O servidor entende todos os elementos padrão do Fountain. Cabeçalhos de cena, indicações de personagem, diálogo, parênteses, transições, linhas de ação, cabeçalhos de seção e notas.

Estimativa de duração

O servidor estima a duração com base na regra padrão de 1 página equivale a 1 minuto de tempo de tela. A contagem de páginas é calculada a partir das linhas de ação e diálogo.

Licença

MIT