Provides natural language access to MongoDB movie databases, enabling search by title, genre, actor, year, and rating, as well as retrieving top-rated movies and detailed movie information from the sample_mflix collection.
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_mflixdatabase withmoviescollection
Installation
Clone this repository:
Install dependencies:
Create a
.envfile with your MongoDB connection string:
Edit the .env file to add your actual MongoDB URI.
Usage
Configure the MCP server in Claude desktop with the following config:
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:
count_movies
Count movies matching criteria:
get_top_movies
Get highest rated movies:
get_movie_details
Get full details for a specific movie:
License
MIT