movie-mcp-simple

patw/movie-mcp-simple

3.2

If you are the rightful owner of movie-mcp-simple and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The Movie Database MCP Server is a FastMCP server that allows users to interact with a MongoDB movie database using natural language queries.

Tools
  1. find_movies

    Search for movies with various filters such as title, genre, actor, year, or minimum rating.

  2. count_movies

    Count the number of movies that match given criteria like genre, year, or minimum rating.

  3. get_top_movies

    Retrieve the highest rated movies based on year or genre.

  4. get_movie_details

    Get full details for a specific movie by title.

Movie Database MCP Server (Simplified)

A FastMCP server that provides access to a MongoDB movie database with natural language queries.

Features

  • Search movies by title, genre, actor, year, or rating
  • Get top-rated movies by year or genre
  • Count movies matching criteria
  • Get detailed information about specific movies

Prerequisites

  • Python 3.7+
  • MongoDB (local or cloud)
  • sample_mflix database with movies collection

Installation

  1. Clone this repository:
git clone https://github.com/patw/movie-mcp-simple.git
cd movie-mcp-simple
  1. Install dependencies:
pip install pymongo fastmcp python-dotenv
  1. Create a .env file with your MongoDB connection string:
cp sample.env .env

Edit the .env file to add your actual MongoDB URI.

Usage

Configure the MCP server in Claude desktop with the following config:

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

Example queries you can ask:

  • "Find movies with Tom Hanks"
  • "How many Comedy movies are there?"
  • "What are the top 5 movies from 1994?"
  • "Show me details for The Shawshank Redemption"

MCP Tools

The server provides these tools:

find_movies

Search for movies with various filters:

find_movies(title=None, genre=None, actor=None, year=None, min_rating=None, limit=10)

count_movies

Count movies matching criteria:

count_movies(genre=None, year=None, min_rating=None)

get_top_movies

Get highest rated movies:

get_top_movies(year=None, genre=None, limit=5)

get_movie_details

Get full details for a specific movie:

get_movie_details(title)

License

MIT