Movie

Provides movie and TV show data from TMDB via an MCP server, including details, casts, genres, and poster images.

python

1

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "yusaaztrk-movie-mcp-main": {
      "command": "python",
      "args": [
        "server.py"
      ]
    }
  }
}

This MCP server exposes movie and TV show data sourced from TMDB, accessible through a single search tool that lets you look up titles by name and receive rich details such as ratings, genres, cast, runtime, and poster images.

How to use

You connect to the Movie MCP Server using your MCP client and call the search_movie tool with your query. Provide the name of a movie or TV show, and you will receive a detailed result that includes the title, release year, rating, genres, runtime or seasons, cast and crew, a plot overview, and a poster image URL. This lets you build features like search interfaces, enriched media catalogs, or recommendations based on real TMDB data.

How to install

Prerequisites: you need Python installed on your system (commonly Python 3.x). Ensure you have access to install Python packages via pip.

pip install -r requirements.txt

python server.py

Additional notes

The server provides a single MCP tool named search_movie. Use this tool to search for both movies and TV shows by name and retrieve comprehensive information including title, release year, rating, genres, runtime or episodes, cast and director/creator details, plot overview, and poster URL.

Available tools

search_movie

Search for movies and TV shows by name. Returns title, release year, IMDb-style rating and vote count, genres and runtime/season info, cast and director/creator information, plot overview, and a poster image URL.