# media-mcp

Servidor MCP personal para recomendaciones de películas/series (vía [TMDB](https://www.themoviedb.org/)) y seguimiento de vistos/watchlist/episodios en SQLite local.

## Setup

1. Consigue un API Read Access Token gratuito en https://www.themoviedb.org/settings/api
2. `cp .env.example .env` y pon tu token en `TMDB_API_KEY`
3. `npm install`
4. `npm run build`

## Registrar en Claude Code

Añade en `~/.mcp.json` (o `/home/user/.mcp.json`):

```json
{
  "mcpServers": {
    "media-mcp": {
      "command": "node",
      "args": ["/home/user/media-mcp/dist/index.js"],
      "env": { "TMDB_API_KEY": "tu_token_aqui" }
    }
  }
}
```

Reinicia Claude Code y verifica con `/mcp` que aparece conectado.

## Herramientas

| Tool | Qué hace |
|---|---|
| `search_media` | Busca películas/series en TMDB |
| `add_to_watchlist` | Agrega algo a la watchlist |
| `get_watchlist` | Lista watchlist + en progreso |
| `mark_watched` | Marca como visto (con rating/notas opcional) |
| `get_watched_history` | Lista todo lo visto |
| `mark_episode_watched` | Marca un episodio de una serie como visto |
| `get_next_episode` | Próximo episodio pendiente de una serie |
| `get_recommendations` | Recomienda basado en historial o en un título dado |

Los datos se guardan en `data/media.db` (SQLite, gitignored).