LS

laksh-star/mcp-server-tmdb

开发工具

本页由 AI 翻译,技术细节请以原文为准。 查看原文

75 stars 30 forks 质量 74 趋势 18MIT

laksh-star/mcp-server-tmdb 是从 https://github.com/laksh-star/mcp-server-tmdb. 导入的 MCP 服务器候选

概览

laksh-star/mcp-server-tmdb 是从 https://github.com/laksh-star/mcp-server-tmdb. 导入的 MCP 服务器候选

概述(AI 翻译)

电影数据库(TMDB)API的MCP服务器。它提供电影和电视搜索、流媒体可用性、演员和工作人员详情,以及对Codex和Claude Desktop等助理的推荐。

关于可重用MCP服务器与更高层级功能工作流程的架构,请参见 USERGUIDE.md。

工具

电影发现

  • get_weekend_watchlist — 按情绪、国家、语言、片长、收视率和服务排名的周末候选名单
  • plan_watch_party — 团体电影之夜计划,包含主选片、备选、外卡、派对理由、供应商可用性及回避标题过滤
  • build_franchise_watch_order — 系列/宇宙指南,包含发行顺序、建议顺序、总时长及供应商相关说明
  • build_collection_gap_plan — 特许经营完成计划,包含被监视/缺失的条目、剩余运行时间、提供者可用性和完成路径
  • recommend_from_taste_profile — 来自喜欢/不喜欢的标题推荐,包含供应商意识评分、比赛理由和警告
  • build_release_calendar_watchlist — 发布窗口观看列表,包含即将上映的电影、供应商准备的推荐、宽广的房间基线和后续观看评分

本页由 AI 翻译,技术细节请以原文为准。

README

以下为原文 README 节选,完整内容请查看原文。

TMDB MCP Server

An MCP server for The Movie Database (TMDB) API. It provides movie and TV search, streaming availability, cast and crew details, and recommendations for assistants such as Codex and Claude Desktop.

For the architecture split between the reusable MCP server and higher-level feature workflows, see USERGUIDE.md.

Tools

Movie Discovery

  • get_weekend_watchlist — Ranked weekend shortlist by mood, country, language, runtime, rating, and services
  • plan_watch_party — Group movie-night plan with a primary pick, backup, wildcard, party-fit reasons, provider availability, and avoided-title filtering
  • build_franchise_watch_order — Franchise/universe guide with release order, suggested order, total runtime, and provider-aware notes
  • build_collection_gap_plan — Franchise completion plan with watched/missing entries, remaining runtime, provider availability, and completion path
  • recommend_from_taste_profile — Recommendations from liked/disliked titles with provider-aware scoring, match reasons, and cautions
  • build_release_calendar_watchlist — Release-window watchlist with upcoming movies, provider-ready picks, broad-room baselines, and watch-later scoring
  • search_movies — Search by title/keywords → titles, IDs, ratings, overviews
  • get_trending — Top 10 trending movies (timeWindow: “day” | “week”)
  • get_weekly_trending_by_language — Weekly trending movies grouped by original language into English, Hindi, and Telugu
  • search_by_genre — Movies by genre name, optional year filter
  • advanced_search — Filter by genre, year, min rating, sort, language
  • search_by_keyword — Find movies by theme/keyword (e.g. “zombie”, “heist”)

Movie Details

  • get_movie_details — Full details: cast, crew, runtime, genres, reviews (by movieId)
  • compare_movies — Side-by-side comparison for 2-5 movie IDs with ratings, runtime, cast, director, providers, and best-fit notes
  • get_recommendations — Top 5 recommendations based on a movie ID
  • get_similar_movies — Similar movies via TMDB’s similarity algorithm
  • get_watch_providers — Streaming/rental/purchase availability by country (default: IN)
  • find_where_to_watch — Search 1-5 movie titles and return streaming/rental/purchase availability with preferred-service matches

TV Shows

  • search_tv_shows — Search TV series by title
  • get_trending_tv — Top 10 trending TV shows (timeWindow: “day” | “week”)

People

  • search_person — Find actors, directors, crew by name → ID + known works
  • get_person_details — Full bio + filmography (movies + TV) by personId
  • build_person_watch_path — Actor/director watch path with best-rated, available-now, recent, and starter picks

Resources

  • tmdb:///movie/ — Full movie details in JSON (title, cast, director, reviews, poster URL)

Quick Start

  1. Get a TMDB API key at themoviedb.org → Account Settings → API
在 GitHub 查看完整 README

安装

npx mcp-remote https://tmdb-mcp.<your-workers-subdomain>.workers.dev/mcp
新手?先看 mcpskill.org 教程 →

配置

{ "mcpServers": { "tmdb-remote": { "command": "npx", "args": [ "mcp-remote", "https://tmdb-mcp.<your-workers-subdomain>.workers.dev/mcp" ] } } }