Skip to main content
Glama
director-de-reels
by MrChubby21

MCP Director de Reels

Un servidor MCP (Model Context Protocol) que conecta una IA (opencode, Claude Desktop, Cursor…) con Director de Reels, la app que construí en el Certamen 2 del ramo ChatGPT y Tecnologías de IAG para el Trabajo Académico (UDD, CTR20233).

Director de Reels arma el guion de un reel plano por plano y crea una foto por plano. Con este MCP, en vez de buscar carpetas a mano, le pido a la IA en lenguaje natural: "¿qué reels tengo?", "ábreme el storyboard del pez oscar" o "¿cuánto llevo gastado este mes?".

Para qué lo uso en la U: para practicar Marketing II (ECM321) con piezas reales. Reviso cada reel contra el plan IMC y el creative brief, y comparo costo y objetivo entre versiones (ver UTILIDAD-ACADEMICA.md).

Demostración en video (35 s, grabada el 13-nov-2026): docs/video/demo-opencode.mp4. Muestra opencode haciendo dos pedidos, el MCP llamando a sus herramientas y el storyboard abriéndose en el navegador.

opencode usando el MCP director-de-reels

Autor: Max Deik. Hecho a partir del mcp-starter-kit del curso (rama main, licencia MIT).

Documento

Qué tiene

UTILIDAD-ACADEMICA.md

Qué problema resuelve, para quién y en qué dimensión del aprendizaje aporta (1 página)

DEMO.md

Caso real, antes y después, con lo que se pidió y lo que respondió

DECLARACION-IA-Y-SEGURIDAD.md

Uso de IA, límites conocidos y seguridad

BITACORA.md

Trazabilidad: cada paso con su comando, la salida real y los errores resueltos

Para quien corrige (persona o agente): 3 comandos, 1 minuto

No necesitas la app Director de Reels ni ninguna clave. Funciona en Mac, Windows o Linux con Node 18+:

git clone https://github.com/MrChubby21/mcp-director-de-reels.git && cd mcp-director-de-reels
npm install && npm run build && npm test     # -> "OK: 6 herramientas" y "Prueba de humo superada."
npm run probar-ejemplo                       # -> 9 líneas OK y "Prueba sin la app superada."

probar-ejemplo usa 2 reels reales de ejemplo/ y simula la app cerrada. Comprueba que las 6 herramientas existen, que listar_reels lee los reels y filtra por palabras, que las otras 5 responden "apagado" sin colgarse y que las entradas malas se rechazan. No abre ventanas ni gasta dinero.

npm run probar-director es la prueba contra la app encendida y solo pasa en el computador del autor. Su salida real está en DEMO.md, en el video y en BITACORA.md.

Crear fotos no es parte del MCP, a propósito: cada foto tarda minutos y cuesta dinero (Modal). La evidencia de las fotos son los storyboards de ejemplo/ y el video.

Criterio de la pauta

Dónde está

Funcionamiento

src/tools/director_reels.ts (6 herramientas), npm test, npm run probar-ejemplo

Utilidad académica

UTILIDAD-ACADEMICA.md (1 página, Marketing II)

Demostración antes y después

DEMO.md y video de 35 s

Publicación en GitHub

Este README, el historial de commits y la búsqueda de claves (0 resultados), en DECLARACION-IA-Y-SEGURIDAD.md

Responsabilidad y documentación

DECLARACION-IA-Y-SEGURIDAD.md, opencode.json (permission) y BITACORA.md

Related MCP server: Consail MCP

Herramientas

Herramienta

Qué hace

¿Cambia algo?

estado_director

Revisa si la app está abierta, si tiene clave para guiones y si el motor de fotos está disponible

No, solo lee

listar_reels

Lista los reels del más nuevo al más viejo (título, fecha, planos, fotos, costo). Filtra por palabras del título

No, solo lee

ver_reel

Muestra el guion de un reel plano por plano: tiempo, tipo de plano, movimiento y foto actual

No, solo lee

abrir_storyboard

Abre en el navegador el storyboard del reel (una foto por plano)

Abre una ventana, y la app rehace storyboard.html desde meta.json

abrir_carpeta_reel

Abre en el Finder la carpeta del reel

Abre una ventana

gasto_modal

Dice cuánto se ha gastado este mes en Modal, el servicio que genera las fotos

No, solo lee (la app le consulta a Modal por internet)

Las dos herramientas de ejemplo del kit (listar_aplicaciones y abrir_aplicacion) quedaron desactivadas (archivo src/tools/_aplicaciones.ts; el kit ignora los archivos que empiezan con _). Podían abrir cualquier app del computador y este MCP no las necesita, así que los permisos quedan acotados a las 6 herramientas de arriba.

Lo que este MCP no hace a propósito: crear guiones ni fotos. Esas acciones cuestan dinero (Gemini y Modal), y lo que cuesta dinero no se le deja decidir a un modelo.

Cómo funciona

Tú  →  opencode (IA)  →  este MCP (stdio)  →  API local del Director (http://127.0.0.1:8895)
                                           →  carpeta reels-creados/ (solo lectura)

El MCP no hace clics ni toca el código de la app. Le habla a la API HTTP que la app ya tenía. Es la vía más robusta según la guía del kit: API, luego línea de comandos, luego archivos, luego AppleScript, y la interfaz al final.

Requisitos

  • macOS (las herramientas que abren ventanas usan el Finder y el navegador del Mac).

  • Node.js 18 o superior y npm (probado con Node 20).

  • La app Director de Reels encendida en el mismo computador (servidor en el puerto 8895). Sin la app, listar_reels igual funciona si existe la carpeta de reels, y las demás herramientas responden "el Director está apagado" sin colgarse.

  • Un cliente MCP: opencode (es el que se usó), Claude Desktop, Cursor u otro. Si no tienes opencode, el kit lo instala con npm run instalar-ia, o se instala desde su página.

Instalación paso a paso

  1. Descarga el repositorio:

    git clone https://github.com/MrChubby21/mcp-director-de-reels.git
    cd mcp-director-de-reels
  2. Instala y compila:

    npm install
    npm run build
  3. Corre la prueba de humo del kit. Debe decir OK: 6 herramientas y terminar con Prueba de humo superada.:

    npm test
  4. Abre la app Director de Reels y corre la prueba real. Llama a las 6 herramientas contra la app encendida (las dos que abren ventanas, con un reel que no existe, para no abrir nada) y debe terminar con Prueba del Director superada.:

    npm run probar-director
  5. Abre opencode en esta carpeta. El archivo opencode.json ya registra el MCP con el nombre director-de-reels y le niega a la IA los comandos de terminal, la edición de archivos y la web (permission), así que solo puede usar las herramientas del MCP:

    opencode

    Si quieres usar el modelo gratis con el que se probó: opencode -m opencode/big-pickle.

Si no tienes la app Director de Reels

La app es mía y no está en este repositorio. Para que igual puedas ver el MCP con datos reales, la carpeta ejemplo/reels-creados/ trae 2 reels reales del Director (su meta.json y su storyboard, con fotos achicadas):

npm run probar-ejemplo

Con eso, listar_reels muestra los 2 reels con su título, planos, fotos y costo, y las herramientas que necesitan la app responden "El Director de Reels esta apagado" sin colgarse. La prueba termina con Prueba sin la app superada.. El storyboard se puede abrir a mano en ejemplo/reels-creados/<reel>/storyboard/storyboard.html. Para opencode en Mac o Linux: DIRECTOR_REELS_DIR=./ejemplo/reels-creados opencode.

En resumen, sin la app:

Paso

¿Se puede repetir?

1 a 3 (npm install, npm run build, npm test)

Sí, completos

4

Usa npm run probar-ejemplo en vez de probar-director: pasa completa sin la app

5 (opencode)

El MCP aparece conectado. Con la carpeta de ejemplo, listar_reels responde con los 2 reels; las demás herramientas dicen que la app está apagada

Este repositorio sirve además como ejemplo de cómo conectar un MCP a cualquier app con una API HTTP local: se cambia DIRECTOR_URL y las rutas que llama src/tools/director_reels.ts.

Archivos heredados del kit

Este repositorio parte del kit del profesor y conserva sus archivos, por si alguien quiere crear otro MCP desde aquí. Para usar este MCP no hacen falta:

Archivo o carpeta

Qué es

Iniciar.command, Iniciar.bat, install.sh, install.ps1, instalador/

Instaladores y menú del kit (Mac y Windows)

constructor/

Constructor web del kit para crear MCPs

templates/, scripts/new-tool.mjs

Plantilla para agregar herramientas nuevas

docs/ (salvo docs/img/)

Guías del kit; su README original está en docs/KIT-ORIGINAL-README.md

src/tools/_ejemplo.ts, src/tools/_aplicaciones.ts

Herramientas de ejemplo del kit, desactivadas

Lo propio de este MCP: src/tools/director_reels.ts, scripts/probar-director.mjs, scripts/probar-ejemplo.mjs, ejemplo/ y los documentos de la raíz.

Configuración opcional

Variable

Para qué

Valor por defecto

DIRECTOR_URL

Dirección del servidor del Director

http://127.0.0.1:8895

DIRECTOR_REELS_DIR

Carpeta donde el Director guarda los reels

~/Desktop/Proyectos/Reels/director-de-reels/reels-creados

Usarlo desde Claude Desktop u otro cliente

Agrega esto a la configuración MCP del cliente, con la ruta absoluta a tu carpeta:

{
  "mcpServers": {
    "director-de-reels": {
      "command": "node",
      "args": ["/ruta/a/mcp-director-de-reels/dist/index.js"]
    }
  }
}

Ejemplos de uso

Le escribes a la IA

Herramientas que usa

¿Qué reels tengo? Muéstrame los 3 más recientes

listar_reels

Abre el storyboard del pez oscar y dime qué movimiento tiene cada plano

ver_reel y abrir_storyboard

¿Tengo algún reel de aros dorados?

listar_reels con buscar

¿Cuánto llevo gastado este mes en fotos?

gasto_modal

¿Está lista la app?

estado_director

Agregar una herramienta

npm run new-tool -- nombre_herramienta

Edita el archivo nuevo en src/tools/, corre npm run build y reinicia el cliente. El kit carga solo todos los archivos de src/tools/, menos los que empiezan con _.

Créditos y licencia

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      B
      quality
      B
      maintenance
      Enables an AI assistant to read and manage a local project-management database over stdio: listing and creating projects, tasks, expenses, chats and people, and pulling money, margin, deadline and overdue summaries. It runs on the same service layer and SQLite file as the bundled web UI, so figures shown to the assistant and to the human always agree.
      14
      -
    • A
      license
      Not graded
      quality
      B
      maintenance
      Connects agents to Consail over local stdio, providing read-only, allowlisted tools to inspect environments, catalogs, datasets, actions, and validate pipelines without exposing database credentials or secret APIs.
      Apache 2.0
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables compatible AI clients to connect to a local Coinbase Agentic Wallet through stdio MCP, so they can read wallet status, public address, Base USDC balance, and saved operations without signing, transferring, trading, or making payments.
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI agents to drive a live Blender session over stdio, inspecting the scene graph, searching and calling operators, reading and writing RNA properties, rendering viewable images, and checkpointing or restoring the file across a multi-turn conversation. It also exposes gallery and scene-reset helpers so the agent can check its own work and start over cleanly.
      19
      GPL 3.0