IMDB

You can access IMDB data through a cloud-runnable JSON-RPC MCP server designed to work with large language models. This server exposes familiar movie and people data retrieval tools, enabling you to query IMDB data programmatically and integrate answers into your AI workflows.

How to use

To use this MCP server, connect your MCP client to the server’s MCP URL and enable the server’s tools in your LLM configuration. Once connected, you can discover available tools, send queries, and receive structured results that you can interpret and present to users.

How to install

Prerequisites: You need Python and the required dependencies listed in the project. Ensure you have network access to install Python packages and to run the server locally or in your chosen environment.

# Install dependencies
pip install -r requirements.txt

# Run the server locally
python app.py

Configuration and usage notes

This MCP server provides a remote HTTP MCP endpoint to integrate with your LLM. The example demonstrates how to add the MCP server URL to your LLM configuration so the LLM can discover and call the server’s tools.

{
  "mcpServers": {
    "imdb": {
      "url": "https://your-deployed-url.com/mcp",
      "transport": "http"
    }
  }
}

Local development and deployment options

You can run the server locally with Python or containerize it with Docker for cloud deployments. Choose the deployment method that matches your infrastructure.

# Docker build and run (example)
docker build -t imdb-mcp .
docker run -p 8080:8080 imdb-mcp

Notes and limitations

Cinemagoer-based querying may involve web scraping, which can affect response times compared to API-based solutions. Use this server in non-commercial contexts that comply with IMDB terms of service.

Available tools

search_movies

Search movies by title and return a list of matching titles with basic details.

get_movie_details

Fetch full information for a specific movie by its identifier.

search_people

Search actors or directors by name and return matching profiles.

get_person_details

Get detailed information and filmography for a person.

get_top_250_movies

Retrieve IMDB Top 250 movies with optional limit.

get_movie_cast

Get the cast list for a given movie with optional limit.