find_moviesLABSCO SUMMARY
A film catalogue you can interrogate by asking.
Four tools cover the shapes a question about a film collection actually takes — find some, count them, rank them, or open one up. The database stays where it is; what changes is that you stop writing the query.
What it is
A FastMCP server over a MongoDB movie database — the sample_mflix database and its movies collection. Four tools turn a spoken-style question into a query against it.
What you get
- Movies found by title, genre, actor, year or minimum rating, with a limit you set
- A count of the movies matching those same criteria
- The highest-rated movies for a year or a genre
- Full details for one movie you name
Requirements
Python 3.7 or newer, a MongoDB instance you can reach, and the sample_mflix database with its movies collection loaded. The connection string goes in a .env file.
Setup effort
Build from source — git clone https://github.com/patw/movie-mcp-simple.git
USE CASES
01
Answering a question about an actor's filmography
Search on the actor and take the list back, then open any one of them for the full record. No aggregation pipeline to write first.
02
Sizing a slice of the catalogue before you analyse it
Count first — how many comedies, how many from that year — so you know whether the slice is worth pulling in full.
03
Picking something to watch from a year or a genre
Ask for the top titles in that year or genre, then open the one that looks right for the plot, cast and runtime.
04
Filtering out the weak entries
Set a minimum rating on the search so the list comes back already trimmed, and count the same criteria to see how much you dropped.
4 tools
Listed in project docs. Your client may show a different list.
count_moviesget_top_moviesget_movie_detailsBEFORE YOU INSTALL
What to know first
Tools you get
4 tools named in the project's documentation.
Requires
Python 3.7+
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
You clone this one yourself.
Server setup
TERMINAL
git clone https://github.com/patw/movie-mcp-simple.git
cd movie-mcp-simple
pip install pymongo fastmcp python-dotenv
cp sample.env .envEdit the .env file to add your actual MongoDB URI
Add the mcpServers entry to the Claude Desktop config
MCP Clients
Any MCP client
ANY MCP CLIENT · JSON
{
"mcpServers": {
"Movie Database": {
"command": "uv",
"args": [
"run",
"--with",
"fastmcp, pymongo",
"fastmcp",
"run",
"<YOUR_PATH_TO>/movie-mcp-simple/movie-mcp.py"
]
}
}
}
