Movie Database

Movie Database is an MCP server that connects large language models to a MongoDB instance hosting movie data, specifically targeting the sample_mflix database collection. Built with FastMCP and PyMongo, this tool enables developers, analysts, and film enthusiasts to query structured cinema records using natural conversational prompts instead of writing complex MongoDB aggregation pipelines. By exposing purpose-built tools, it allows users to search movie catalogues by title, actor, genre, year, and rating thresholds. Users can retrieve granular movie details, fetch top-rated releases for specific periods, or tally films matching specified filters. The server acts as a bridge between an AI assistant and a local or cloud-hosted MongoDB cluster, converting user requests into database operations and returning formatted document data directly into the chat session for immediate analysis.

Category: Data & Analytics

Tags: mongodb, movies, nosql, query

Visit Movie Database

How to install and configure Movie Database

1. Clone the repository locally: bash git clone https://github.com/patw/movie-mcp-simple.git cd movie-mcp-simple 2. Install the necessary Python packages: bash pip install pymongo fastmcp python-dotenv 3. Create your configuration file and set your MongoDB URI: bash cp sample.env .env 4. Add the server configuration to your Claude Desktop config file: json { "mcpServers": { "Movie Database": { "command": "uv", "args": [ "run", "--with", "fastmcp, pymongo", "fastmcp", "run", "<path to>/movie-mcp-simple/movie-mcp.py" ] } } } Replace <path to> with your actual local repository path.

What you can do with Movie Database

• Querying filmographies by filtering movie records by actor name, genre, release year, or minimum rating through natural conversation. * Calculating total catalog counts for specific cinema genres or release years directly through MongoDB queries. * Fetching the highest-rated releases for a chosen year or genre to compile curated recommendation lists. * Pulling comprehensive metadata and plot details for a specific movie title to review database records.

Key facts

• https://github.com/patw/movie-mcp-simple
• Data & Analytics, Databases & Data Stores
• mongodb, movies, nosql, query

Part of MCP Servers

What can Movie Database do?

Movie Database provides tools to query a MongoDB movie collection using natural language. It allows you to search for films by actor, genre, year, and rating, retrieve detailed information for specific titles, calculate total movie counts by criteria, and list top-rated films.

What are the prerequisites for Movie Database?

The server requires Python 3.7 or higher, a running MongoDB instance either locally or in the cloud, and the sample_mflix database loaded with a movies collection. It also requires the fastmcp, pymongo, and python-dotenv packages.

Which MCP clients work with Movie Database?

Movie Database works with Claude Desktop and other Model Context Protocol clients capable of running local command-line subprocesses configured with uv or Python.

Is Movie Database open source?

Yes, Movie Database is open source and licensed under the MIT License on GitHub.