Skip to main content
Glama
Sign In
media-mcp

media-mcp

by emedinamaza
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Local

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

Related MCP server: MediaSage

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

Available Tools

8 tools
add_to_watchlistadd_to_watchlistB

Agrega una película o serie a la watchlist (pendiente de ver).

Inputs: tmdb_id (required), media_type (required).

get_next_episodeget_next_episodeC

Encuentra el próximo episodio no visto de una serie.

Inputs: tmdb_id (required).

get_recommendationsget_recommendationsA

Recomienda películas o series. Si das 'based_on' recomienda parecidos a ese título; si no, usa tu historial de vistos como base.

Inputs: limit, based_on, media_type.

get_watched_historyget_watched_historyA

Lista todo lo marcado como visto, con rating y notas.

Inputs: no named parameters.

get_watchlistget_watchlistA

Lista lo que está en watchlist o en progreso (watching).

Inputs: no named parameters.

mark_episode_watchedmark_episode_watchedB

Marca un episodio específico de una serie como visto.

Inputs: tmdb_id (required), season_number (required), episode_number (required).

mark_watchedmark_watchedA

Marca una película o serie (a nivel general) como vista, opcionalmente con rating y notas. Para episodios sueltos de una serie usa mark_episode_watched.

Inputs: tmdb_id (required), media_type (required), notes, rating.

search_mediasearch_mediaA

Busca películas o series en TMDB por título.

Inputs: query (required), media_type.

Tool Schema Changelog

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

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    A3.6/5.0

    Scored across 8 tools

    Disambiguation5/5

    Each tool targets a distinct operation: adding to watchlist, getting next episode, recommendations, history, watchlist, marking episodes, marking media, and searching. No overlap in functionality.

    Naming Consistency4/5

    Most tools follow a verb_object pattern (get_watchlist, mark_watched, search_media). However, add_to_watchlist uses a preposition, breaking the pattern slightly. Overall clear and predictable.

    Tool Count5/5

    8 tools is well-scoped for a media tracking server, covering essential operations from search to watchlist management to recommendations without being excessive.

    Completeness3/5

    Covers core read and create operations but lacks update/delete tools (e.g., remove from watchlist, update rating). Episode tracking only allows marking individual episodes, not seasons.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Resources

    Related MCP Connectors

    Related MCP Servers

    • MediaSage

      imjoshnewton
      F
      license
      Not graded
      quality
      D
      maintenance
      Tracks movies, books, and TV shows with ratings and preferences, providing intelligent cross-media recommendations. Automatically fetches metadata from OMDB, Google Books, and TMDB to help manage watchlists and analyze viewing patterns.
      1
      -

    • TMDB MCP Server

      tcehjaava
      A
      license
      A
      quality
      D
      maintenance
      Provides access to The Movie Database (TMDB) API, enabling users to search for movies, TV shows, and people, get detailed information, discover content with advanced filters, and retrieve recommendations.
      13
      81 npm
      5
      MIT

    • TMDB MCP Server

      adamayoung
      A
      license
      Not graded
      quality
      D
      maintenance
      Integrates with The Movie Database (TMDB) API to provide movie information, search capabilities, and recommendations.
      10 npm
      MIT