Movie MCP Server

This project provides a Python script that exposes a set of powerful tools for querying and analyzing a MongoDB movie database (specifically the

Remote serverstreamable-httpPython

What is the Movie MCP MCP server?

Connect Movie MCP to Claude, Cursor or any other MCP client and it stops being a tab you switch to. This project provides a Python script that exposes a set of powerful tools for querying and analyzing a MongoDB movie database (specifically the sample_mflix dataset) using the fastmcp library. These tools are designed to be easily. The movie mcp mcp server is what makes that connection.

What the server does

  • Comprehensive Movie Search: — Find movies by title, genre, actors, directors, writers, year, or various rating thresholds
  • Flexible Data Retrieval: — Specify fields to return (projection_fields) and control sorting (sort_by, sort_order_asc)
  • Movie Counting: — Quickly count movies matching specific criteria
  • Average Rating Calculation: — Compute average IMDb, Metacritic, or Rotten Tomatoes ratings for filtered movie sets
  • LLM-Friendly: — Designed with fastmcp to create a robust, self-documenting API easily consumable by LLMs. Includes special handling for stringified list arguments, addressing common LLM output formats
  • Robust MongoDB Integration: — Utilizes pymongo for efficient and reliable database operations

Available tools

The toolset is worth reading before you wire it up, because it tells you what the integration is really for:

  • Optionally — The Optionally tool exposed by this server
  • find_movies — Finds movies based on a variety of criteria, with options for sorting and limiting results
  • count_movies — The count_movies tool exposed by this server
  • get_average_rating — Calculates the average rating for movies matching the criteria, for a specific rating type

Installation

Because this one is hosted, setup is mostly authentication — you point your client at the endpoint and approve access. Nothing runs on your machine, so there is no runtime to keep patched.

Credentials and setup notes

Before running this project, ensure you have the following: * Python 3.7+: Download Python * MongoDB Instance: A running MongoDB instance (local or cloud-hosted like MongoDB Atlas). * sample_mflix Dataset: The sample_mflix database and its movies collection must be loaded into your MongoDB instance.

Where it fits

This sits in the database access group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. Movie MCP's toolset — Optionally, find_movies, count_movies and 1 more — is a fair guide to whether it matches your workflow. It is maintained by patw; worth a glance at recent repository activity before you build anything load-bearing on it.

This entry was verified against Movie MCP's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.

Worth knowing first

  • Your data travels to the provider's service, so the usual questions apply about what you send and what they retain.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

Available tools

ToolWhat it does
OptionallyThe Optionally tool exposed by this server.
find_moviesFinds movies based on a variety of criteria, with options for sorting and limiting results.
count_moviesThe count_movies tool exposed by this server.
get_average_ratingCalculates the average rating for movies matching the criteria, for a specific rating type.

How to install the Movie MCP MCP server

{
  "mcpServers": {
    "Movie Database": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "fastmcp, pymongo",
        "fastmcp",
        "run",
        "<path to>/movie-mcp/movie-mcp.py",
        "<mongo connection string URI>"
      ]
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

Before running this project, ensure you have the following: * Python 3.7+: Download Python * MongoDB Instance: A running MongoDB instance (local or cloud-hosted like MongoDB Atlas). * sample_mflix Dataset: The sample_mflix database and its movies collection must be loaded into your MongoDB instance.

Example prompts to try

  • Use Movie MCP to Optionally.
  • Use Movie MCP to find movies.
  • Use Movie MCP to count movies.

Frequently asked questions

It connects Movie MCP to MCP-compatible AI assistants such as Claude and Cursor, exposing 4 tools (Optionally, find_movies, count_movies, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Movie MCP directly.