director-de-reels
Reports how much has been spent this month on Modal, the service that generates the reel photos, by querying the Director de Reels app's local API (read-only).
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
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.

Autor: Max Deik. Hecho a partir del mcp-starter-kit del curso (rama main, licencia MIT).
Documento | Qué tiene |
Qué problema resuelve, para quién y en qué dimensión del aprendizaje aporta (1 página) | |
Caso real, antes y después, con lo que se pidió y lo que respondió | |
Uso de IA, límites conocidos y seguridad | |
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 |
|
Utilidad académica | UTILIDAD-ACADEMICA.md (1 página, Marketing II) |
Demostración antes y despué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, |
Related MCP server: Consail MCP
Herramientas
Herramienta | Qué hace | ¿Cambia algo? |
| Revisa si la app está abierta, si tiene clave para guiones y si el motor de fotos está disponible | No, solo lee |
| 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 |
| Muestra el guion de un reel plano por plano: tiempo, tipo de plano, movimiento y foto actual | No, solo lee |
| Abre en el navegador el storyboard del reel (una foto por plano) | Abre una ventana, y la app rehace |
| Abre en el Finder la carpeta del reel | Abre una ventana |
| 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_reelsigual 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
Descarga el repositorio:
git clone https://github.com/MrChubby21/mcp-director-de-reels.git cd mcp-director-de-reelsInstala y compila:
npm install npm run buildCorre la prueba de humo del kit. Debe decir
OK: 6 herramientasy terminar conPrueba de humo superada.:npm testAbre 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-directorAbre opencode en esta carpeta. El archivo
opencode.jsonya registra el MCP con el nombredirector-de-reelsy 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:opencodeSi 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-ejemploCon 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 ( | Sí, completos |
4 | Usa |
5 (opencode) | El MCP aparece conectado. Con la carpeta de ejemplo, |
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 |
| Instaladores y menú del kit (Mac y Windows) |
| Constructor web del kit para crear MCPs |
| Plantilla para agregar herramientas nuevas |
| Guías del kit; su README original está en |
| 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 |
| Dirección del servidor del Director |
|
| Carpeta donde el Director guarda los reels |
|
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 |
|
Abre el storyboard del pez oscar y dime qué movimiento tiene cada plano |
|
¿Tengo algún reel de aros dorados? |
|
¿Cuánto llevo gastado este mes en fotos? |
|
¿Está lista la app? |
|
Agregar una herramienta
npm run new-tool -- nombre_herramientaEdita 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
Base: mcp-starter-kit del profesor Mauricio Reyes, licencia MIT. Su README original está en docs/KIT-ORIGINAL-README.md, y su documentación en
docs/.Herramientas del Director, prueba real y documentación: Max Deik, con ayuda de IA (detalle en DECLARACION-IA-Y-SEGURIDAD.md).
Licencia: MIT (ver LICENSE).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Run any Relay model (image, video, audio, LLM), poll tasks, upload files and search Relay's docs.
Read a project's prompts, logs and agents, and send new work to the agent on your own machines.
Remote streamable-HTTP MCP server running on a single Cloudflare Worker. Your assistant gets live Airbnb, Amazon, Booking.com, Google Flights, Maps and Reddit data, social search on X, Instagram and TikTok, the Meta Ad Library, and image/video generation without any keys. Connect your own accounts to let it send WhatsApp or Telegram messages, work an IMAP inbox, manage Meta Ads campaigns and publish to X and LinkedIn. OAuth 2.1 with PKCE; stored credentials are AES-256-GCM encrypted.
Talk to your public-facing AI from any MCP client — Claude, ChatGPT, Cursor, Cline, Windsurf.
Related MCP Servers
- FlicenseBqualityBmaintenanceEnables 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-

Consail MCPofficial
AlicenseNot gradedqualityBmaintenanceConnects 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
Agent Wallet Gatewayofficial
AlicenseNot gradedqualityCmaintenanceEnables 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- AlicenseNot gradedqualityBmaintenanceEnables 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.19GPL 3.0