media-mcp

Servidor MCP personal para recomendaciones de películas/series (vía TMDB) 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):

{
  "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).