Mcp Server With Tmdb
by
Provides movie data, search, trending lists, and recommendations by integrating the TMDB API.
Mcp Server With Tmdb Overview
What is Mcp Server With Tmdb about?
Mcp Server With Tmdb integrates the The Movie Database (TMDB) API into an MCP server, exposing tools and resources that let users search for movies, retrieve detailed information, get trending titles, and receive recommendations directly from compatible clients such as Claude Desktop.
How to use Mcp Server With Tmdb?
- Obtain a TMDB API key from the TMDB developer dashboard.
- Install the server (preferably via Smithery) with:
npx -y @smithery/cli install @Laksh-star/mcp-server-tmdb --client claude - Set the environment variable so the server can authenticate with TMDB:
export TMDB_API_KEY=your_api_key_here - Add the server to Claude Desktop (or any MCP‑compatible client) by referencing the installed package path and the
TMDB_API_KEYvariable. - Run the compiled entry point (
dist/index.js) or let the client launch it automatically.
Key Features
- search_movies: Find movies by title or keywords; returns titles, release years, IDs, ratings, and overviews.
- get_recommendations: Provide the top 5 recommended movies based on a given TMDB movie ID.
- get_trending: List the top 10 trending movies for a day or a week.
- Movie resource (
tmdb:///movie/<movie_id>): Returns comprehensive JSON data including title, release date, rating, overview, genres, poster URL, top 5 cast members, director, and selected reviews. - Full TypeScript codebase, easy to build (
npm run build) and watch (npm run watch). - Robust error handling for invalid API keys, network issues, malformed requests, and missing movie IDs.
Use Cases
- Claude Desktop integration: Enable conversational agents to answer movie‑related queries without leaving the chat interface.
- Personal movie dashboards: Build web or mobile apps that display trending movies, search results, or recommendations.
- Content curation: Automate the generation of movie lists for newsletters, blogs, or social media posts.
- Research and analytics: Pull structured movie metadata for data‑science projects or trend analysis.
FAQ
- Where do I get the TMDB API key? Sign up at https://www.themoviedb.org/, navigate to the API section of your account, and request a developer key.
- Which operating systems are supported? macOS 10.15+ and modern Linux distributions.
- What if I provide an invalid API key? The server returns a clear error message indicating authentication failure.
- Can I run the server without Claude Desktop?
Yes, you can invoke the compiled
dist/index.jsdirectly or wrap it in any MCP‑compatible client. - How do I update the server?
Re‑run the
npx @smithery/cli installcommand or pull the latest code from the repository and rebuild.
Mcp Server With Tmdb's README
TMDB MCP Server
This MCP server integrates with The Movie Database (TMDB) API to provide movie information, search capabilities, and recommendations.
Prerequisites
Before installing and running the TMDB MCP server, ensure you have the following prerequisites installed and configured:
Required software
-
Node.js
- Version 18.0.0 or higher
- Download from Node.js official website
- Verify installation:
node --version
-
npm (Node Package Manager)
- Version 8.0.0 or higher (comes with Node.js)
- Verify installation:
npm --version
-
TypeScript
- Will be installed as a project dependency
- Can be installed globally:
npm install -g typescript - Verify installation:
tsc --version
Required accounts & API keys
-
TMDB account
- Free account at TMDB
- API key from TMDB dashboard
- API access must be approved by TMDB
-
Claude desktop application
- Latest version installed
- Access to modify configuration files
System requirements
-
Operating systems
- macOS (10.15 or later)
- Linux (modern distributions)
-
Hardware requirements
-
Minimum 4GB RAM
- 1GB free disk space
- Stable internet connection
Development environment
For the best development experience, we recommend:
- A code editor with TypeScript support (e.g., VS Code)
- Terminal access
- Git (for version control)
Features
Tools
-
search_movies
- Search for movies by title or keywords
- Input:
query(string): Search query - Returns: List of movies with titles, release years, IDs, ratings, and overviews
- Example: Search for movies about space exploration
-
get_recommendations
- Get movie recommendations based on a movie ID
- Input:
movieId(string): TMDB movie ID - Returns: Top 5 recommended movies with details
- Example: Get recommendations based on movie ID 550 (Fight Club)
-
get_trending
- Get trending movies for a specified time window
- Input:
timeWindow(string): Either "day" or "week" - Returns: Top 10 trending movies with details
- Example: Get today's trending movies
Resources
The server provides access to TMDB movie information:
- Movies (
tmdb:///movie/<movie_id>)- Comprehensive movie details including:
- Title and release date
- Rating and overview
- Genres
- Poster URL
- Cast information (top 5 actors)
- Director
- Selected reviews
- All data is returned in JSON format
- Comprehensive movie details including:
Getting started
-
Get a TMDB API key:
- Sign up at TMDB
- Go to your account settings
- Navigate to the API section
- Request an API key for developer use
-
Clone and set up the project:
git clone [repository-url] cd mcp-server-tmdb npm install -
Build the server:
npm run build -
Set up your environment variable:
export TMDB_API_KEY=your_api_key_here
Usage with Claude Desktop
To integrate this server with Claude Desktop, add the following to your app's server configuration file (located at ~/Library/Application Support/Claude/config.json):
{
"mcpServers": {
"tmdb": {
"command": "/full/path/to/dist/index.js",
"env": {
"TMDB_API_KEY": "your_api_key_here"
}
}
}
}
Replace /full/path/to with the actual path to your project directory.
Installing via Smithery
To install TMDB Server for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @Laksh-star/mcp-server-tmdb --client claude
Example usage
Once the server is running with Claude Desktop, you can use commands like:
-
Search for movies:
"Search for movies about artificial intelligence" -
Get trending movies:
"What are the trending movies today?" "Show me this week's trending movies" -
Get movie recommendations:
"Get movie recommendations based on movie ID 550" -
Get movie details:
"Tell me about the movie with ID 550"
Error handling
The server includes comprehensive error handling for:
- Invalid API keys
- Network errors
- Invalid movie IDs
- Malformed requests
Error messages will be returned in a user-friendly format through Claude Desktop.
Development
To watch for changes during development:
npm run watch
License
This MCP server is licensed under the MIT License. See the LICENSE file for details.
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
Mcp Server With Tmdb Reviews
Login Required
Please log in to share your review and rating for this MCP.
Actions
Mcp Server With Tmdb's Information
- Author
- Laksh-star
- Category
- Search
- Language
- JavaScript
- License
- MIT License
- Version
- v1.0.0
- Stars
- 49
- Updated
- 2 months ago
Configuration
{
"mcpServers": {
"tmdb": {
"command": "npx",
"args": [
"-y",
"@smithery/cli",
"install",
"@Laksh-star/mcp-server-tmdb",
"--client",
"claude"
],
"env": {
"TMDB_API_KEY": "<YOUR_API_KEY>"
}
}
}
}Claude Code (Terminal)
claude mcp add tmdb npx -y @smithery/cli install @Laksh-star/mcp-server-tmdb --client claudeConfigure Clients
Similar MCP Servers like Mcp Server With Tmdb
Explore related MCPs that share similar capabilities and solve comparable challenges
Exa MCP Server
by exa-labs
Provides real-time web search capabilities to AI assistants via a Model Context Protocol server, enabling safe and controlled access to the Exa AI Search API.
Perplexity Ask
by perplexityai
Enables Claude and other MCP‑compatible applications to perform real‑time web searches through the Perplexity (Sonar) API without leaving the MCP ecosystem.
Microsoft Learn MCP Server
by MicrosoftDocs
Provides semantic search and fetch capabilities for Microsoft official documentation, returning content in markdown format via a lightweight streamable HTTP transport for AI agents and development tools.
Elasticsearch MCP Server
by elastic
Enables natural‑language interaction with Elasticsearch indices via the Model Context Protocol, exposing tools for listing indices, fetching mappings, performing searches, running ES|QL queries, and retrieving shard information.
Graphlit MCP Server
by graphlit
Enables integration between MCP clients and the Graphlit platform, providing ingestion, extraction, retrieval, and RAG capabilities across a wide range of data sources and connectors.
Everything Search
by mamertofabian
Fast cross‑platform file searching leveraging the Everything SDK on Windows, Spotlight on macOS, and locate/plocate on Linux.
Elasticsearch OpenSearch MCP Server
by cr7258
Provides Elasticsearch and OpenSearch interaction via Model Context Protocol, enabling document search, index management, cluster monitoring, and alias operations.
Kagi MCP Server
by kagisearch
Provides web search and video summarization capabilities through the Model Context Protocol, enabling AI assistants like Claude to perform queries and summarizations.
MCP Compass
by liuyoshio
Provides natural‑language search and recommendation for Model Context Protocol servers, delivering rich metadata and real‑time updates.