rakeshgangwar_tmdb_mcp_server

rakeshgangwar_tmdb_mcp_server

by rakeshgangwar
An MCP server providing access to The Movie Database (TMDB) API for AI assistants.

TMDB MCP Server: Movie Database Integration for AI Assistants

Overview

The TMDB MCP Server is a Model Context Protocol (MCP) server that provides seamless access to The Movie Database (TMDB) API. This server enables AI assistants to search and retrieve detailed movie information through the MCP interface, making it a powerful tool for integrating movie data into AI workflows.

Features

  • Search Movies: Search for movies by title, year, and other criteria.
  • Retrieve Movie Details: Access comprehensive movie information.
  • AI Integration: Easily integrate with MCP-compatible AI assistants.

Prerequisites

  • Node.js >= 18
  • TMDB API Key: Obtain one from TMDB.

Installation

  1. Clone the repository:

shell git clone https://github.com/rakeshgangwar/tmdb-mcp-server.git cd tmdb-mcp-server

  1. Install dependencies:

shell npm install

  1. Build the server:

shell 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 /path/to/ with the 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:

{
  "query": "Inception",
  "year": 2010,
  "page": 1
}

Development

  1. Make your changes in the src directory.
  2. Build the project:

shell npm run build

  1. 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 file for details.

Acknowledgments

Features & Capabilities

Categories
mcp_server model_context_protocol javascript tmdb api_integration movie_search

Implementation Details

View on GitHub

Stats

0 Views
0 Favorites
1 GitHub Stars

Repository Info

rakeshgangwar Organization

Similar Servers

continuedev_continue by continuedev
0
cherryhq_cherry_studio by CherryHQ
0
bytedance_ui_tars_desktop by bytedance
0
2025© BestAI