narrator-ai-cli-skill MCP — Casos de uso, Instalar & Demo ao vivo

Por que usar

Principais recursos

Wraps narrator-ai-cli flags and subcommands
Handles job submission + polling patterns
Output-file placement conventions
Batch narration across multiple source videos
Fails loudly when API key or config is missing

Demo ao vivo

Como fica na prática

narrator-ai-cli-skill.replay ▶ pronto

0/0

Instalar

Escolha seu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "narrator-ai-cli-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/GridLtd-ProductDev/narrator-ai-cli-skill",
        "~/.claude/skills/narrator-ai-cli-skill"
      ],
      "_inferred": true
    }
  }
}

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "narrator-ai-cli-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/GridLtd-ProductDev/narrator-ai-cli-skill",
        "~/.claude/skills/narrator-ai-cli-skill"
      ],
      "_inferred": true
    }
  }
}

Cursor usa o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "narrator-ai-cli-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/GridLtd-ProductDev/narrator-ai-cli-skill",
        "~/.claude/skills/narrator-ai-cli-skill"
      ],
      "_inferred": true
    }
  }
}

Clique no ícone MCP Servers na barra lateral do Cline, depois "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "narrator-ai-cli-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/GridLtd-ProductDev/narrator-ai-cli-skill",
        "~/.claude/skills/narrator-ai-cli-skill"
      ],
      "_inferred": true
    }
  }
}

Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "narrator-ai-cli-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/GridLtd-ProductDev/narrator-ai-cli-skill",
        "~/.claude/skills/narrator-ai-cli-skill"
      ]
    }
  ]
}

O Continue usa um array de objetos de servidor em vez de um map.

~/.config/zed/settings.json

{
  "context_servers": {
    "narrator-ai-cli-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/GridLtd-ProductDev/narrator-ai-cli-skill",
          "~/.claude/skills/narrator-ai-cli-skill"
        ]
      }
    }
  }
}

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

claude mcp add narrator-ai-cli-skill -- git clone https://github.com/GridLtd-ProductDev/narrator-ai-cli-skill ~/.claude/skills/narrator-ai-cli-skill

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

Casos de uso

Usos do mundo real: narrator-ai-cli-skill

How to narrate a single video from a brief

👤 Creators and editors using Narrator AI for VO ⏱ ~15 min beginner

Quando usar: You have a video and a draft voice-over script and want narration produced via the CLI.

Pré-requisitos

narrator-ai-cli installed and configured — Follow upstream install docs for the CLI
Skill cloned — git clone https://github.com/GridLtd-ProductDev/narrator-ai-cli-skill ~/.claude/skills/narrator-ai-cli-skill

Fluxo

Stage inputs

Given my video scene_01.mp4 and the VO script script.md, run narrator-ai-cli and save the output to ./narrations/.✓ Copiado

→ CLI invocation with correct flags
Wait and verify

Poll until the job is done, then confirm the output file exists and has audio.✓ Copiado

→ Output file present with non-zero duration

Resultado: Narration file ready to drop into your editor.

Armadilhas

Long jobs time out in the shell — Use the CLI's async mode + poll instead of a blocking call

Combine com: filesystem

Batch-narrate a series of scenes

👤 Teams with multi-scene projects ⏱ ~45 min intermediate

Quando usar: You have 10+ scenes with per-scene scripts and need them narrated consistently.

Fluxo

Walk the project structure

Find all scene_*.mp4 + scene_*.md pairs under project/ and queue narration for each.✓ Copiado

→ Enumerated pairs + job queue
Run serially or in parallel

Run up to 3 jobs in parallel; rate-limit per the API allowance.✓ Copiado

→ Controlled concurrency
Report results

Produce a table: scene, status, duration, output path.✓ Copiado

→ Clear completion table

Resultado: Whole project narrated in one run with clear status.

Armadilhas

Hitting API limits mid-batch — Respect upstream rate limits; back off on 429

Combine com: filesystem

Combinações

Combine com outros MCPs para 10× de alavancagem

narrator-ai-cli-skill + filesystem

Find inputs automatically and drop outputs in structured folders

Walk project/, narrate every scene, output to project/narrations/.✓ Copiado

narrator-ai-cli-skill + claude-shorts-skill

Add AI narration to Short clips generated by claude-shorts

For each rendered Short, narrate an intro line and mix it in.✓ Copiado

Ferramentas

O que este MCP expõe

Ferramenta	Entradas	Quando chamar	Custo
cli-invocation	inputs (video+script) + flags	Every narration run	narrator-ai API usage
job-polling	job id	After submission	minimal
batch-orchestration	list of jobs	Multi-scene projects	depends on batch size

Custo e limites

O que custa rodar

Cota de API: depends on Narrator AI tier
Tokens por chamada: minimal LLM tokens; real cost is API minutes
Monetário: API billed by Narrator AI
Dica: Narrate final scripts only; iterate text in LLM first

Segurança

Permissões, segredos, alcance

Armazenamento de credenciais: Narrator AI API key in env var; never inline

Saída de dados: Narrator AI endpoints

Uploaded video/audio passes through third-party service; check data handling policies

Solução de problemas

Erros comuns e correções

Skill doesn't activate

Ensure SKILL.md is at the cloned dir root and Claude Code restarted.

Verificar: ls ~/.claude/skills/narrator-ai-cli-skill/SKILL.md

CLI command not found

Install narrator-ai-cli and make sure it's on PATH where Claude Code runs.

Verificar: which narrator-ai-cli

401 from Narrator API

Set NARRATOR_API_KEY (or the env var the CLI expects).

Verificar: env | grep NARRATOR

Alternativas

narrator-ai-cli-skill vs. outros

Alternativa	Quando usar	Troca
claude-shorts-skill	You want a full long-to-short pipeline, not just narration	Pipeline vs single-purpose

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills