README.md•2.26 kB
# 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](https://www.themoviedb.org/documentation/api))
## Installation
1. Clone the repository:
```bash
git clone https://github.com/rakeshgangwar/tmdb-mcp-server.git
cd tmdb-mcp-server
```
2. Install dependencies:
```bash
npm install
```
3. Build the server:
```bash
npm run build
```
## Configuration
Configure the MCP server in your MCP settings file (typically `cline_mcp_settings.json`):
```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 string
- `year` (optional): Filter by release year
- `page` (optional): Page number (default: 1)
Example:
```javascript
{
"query": "Inception",
"year": 2010,
"page": 1
}
```
## Development
1. Make your changes in the `src` directory
2. Build the project:
```bash
npm run build
```
3. Test your changes by configuring the MCP server in your settings
## Contributing
1. Fork the repository
2. Create your feature branch (`git checkout -b feature/amazing-feature`)
3. Commit your changes (`git commit -am 'Add some amazing feature'`)
4. Push to the branch (`git push origin feature/amazing-feature`)
5. Open a Pull Request
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## Acknowledgments
- [TMDB API](https://www.themoviedb.org/documentation/api) for providing the movie database API
- [Model Context Protocol](https://github.com/modelcontextprotocol) for the MCP SDK