# Banco de B-roll — servidor MCP

Busca clips de video gratuitos en Mixkit y Pexels, y **lleva registro de los ya
usados** para que nunca se repita material entre un video y otro.

---

## Qué hace

| Herramienta | Para qué |
|---|---|
| `buscar_broll` | Busca clips y descarta automáticamente los ya usados en ese proyecto |
| `marcar_usados` | Registra los clips que sí entraron al montaje final |
| `historial` | Muestra qué se ha usado, por proyecto |
| `olvidar` | Borra el registro de un proyecto o de clips puntuales |

El registro es **por proyecto**, así que Conciencia Infinita, Promotores del Eje
y el proyecto de música llevan listas separadas y no se estorban.

---

## Despliegue en Render (la ruta más simple)

**1. Sube los archivos a un repositorio de GitHub**

Los cuatro archivos de esta carpeta: `server.py`, `requirements.txt`,
`render.yaml`, `README.md`.

**2. Crea el servicio en Render**

- Entra a render.com y conecta ese repositorio
- Render lee `render.yaml` y configura todo solo
- El plan gratuito alcanza para este uso

**3. Agrega la clave de Pexels (opcional pero recomendado)**

En Render, sección Environment, agrega `PEXELS_API_KEY` con tu clave. Se saca
gratis en pexels.com/api. Sin ella el servidor funciona igual, pero solo busca
en Mixkit.

**4. Copia la URL que te da Render**

Queda algo así: `https://banco-broll-mcp.onrender.com/mcp`

**5. Conéctalo en Claude**

Configuración → Conectores → Agregar conector personalizado → pega esa URL.

---

## Advertencias reales

**El plan gratuito de Render duerme.** Tras 15 minutos sin uso, el servicio se
apaga y la primera llamada siguiente tarda unos 30 segundos en despertar. Es
molesto, no grave.

**El registro necesita disco persistente.** El `render.yaml` ya incluye un disco
de 1 GB montado en `/var/data`. Si despliegas en otro lado sin disco
persistente, el historial se borra en cada reinicio y se pierde la protección
anti-repetición, que es justamente el punto del servidor. Verifica que el disco
quede montado.

**Mixkit tiene dos licencias.** La libre permite uso comercial; la restringida
es solo uso personal. El servidor no distingue entre las dos automáticamente —
para trabajo de cliente hay que abrir la ficha del clip y confirmar. Los de
Pexels sí son todos de uso comercial libre.

**Mixkit puede cambiar su HTML.** El servidor lee la página directamente, así
que si Mixkit rediseña el sitio, la búsqueda en esa fuente puede dejar de
funcionar hasta ajustar el código. Pexels usa API oficial y es estable.

---

## Prueba rápida en tu computador

```bash
pip install -r requirements.txt
python server.py
```

Queda escuchando en `http://localhost:8000/mcp`.