tmdb-mcp-server
If you are the rightful owner of tmdb-mcp-server 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.
A Model Context Protocol (MCP) server that provides access to The Movie Database (TMDB) API. This server enables AI assistants to search and retrieve movie information through the MCP interface.
TMDB MCP Server
A Model Context Protocol (MCP) server that provides access to The Movie Database (TMDB) API. This server enables AI assistants to search and retrieve movie information through the MCP interface.
Features
- Search movies by title, year, and other criteria
- Retrieve detailed movie information
- Easy integration with MCP-compatible AI assistants
Prerequisites
- Node.js >= 18
- TMDB API key (get one from TMDB)
Installation
- Clone the repository:
git clone https://github.com/rakeshgangwar/tmdb-mcp-server.git
cd tmdb-mcp-server
- Install dependencies:
npm install
- Build the server:
npm run build
Configuration
Configure the MCP server in your MCP settings file (typically cline_mcp_settings.json):
{
"mcpServers": {
"tmdb": {
"command": "node",
"args": ["/path/to/tmdb-mcp-server/dist/index.js"],
"env": {
"TMDB_API_KEY": "your-api-key-here"
},
"disabled": false,
"autoApprove": []
}
}
}
Replace your-api-key-here with your TMDB API key and replace /path/to/ with actual path.
Available Tools
search_movies
Search for movies using The Movie Database API.
Parameters:
query(required): Search query stringyear(optional): Filter by release yearpage(optional): Page number (default: 1)
Example:
{
"query": "Inception",
"year": 2010,
"page": 1
}
Development
- Make your changes in the
srcdirectory - Build the project:
npm run build
- Test your changes by configuring the MCP server in your settings
Contributing
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -am 'Add some amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
License
This project is licensed under the MIT License - see the file for details.
Acknowledgments
- TMDB API for providing the movie database API
- Model Context Protocol for the MCP SDK
