TMDB MCP Server

Model Context Protocol (MCP) server for The Movie Database (TMDB) API.

Features

• Search: movies, TV shows, people, multi
• Trending: daily/weekly for movies, TV, all
• Movies: popular, top_rated, now_playing, upcoming, details, credits, similar, recommendations, videos
• TV: popular, top_rated, airing_today, on_the_air, details, credits, similar, videos
• People: details, movie_credits, tv_credits
• Genres: movie and TV genre lists

Requirements

• Node.js >= 18
• TMDB API Key

Installation

npm install @ryanxili/tmdb-mcp

Quick Start

Install

npm install @ryanxili/tmdb-mcp

Run

# With TMDB API key
TMDB_API_KEY=your_key node node_modules/@ryanxili/tmdb-mcp/index.js

Or create a runner script:

# run.js
import('@ryanxili/tmdb-mcp');

Local Development

# Clone
git clone https://github.com/ryanxili/tmdb-mcp.git
cd tmdb-mcp

# Install
npm install

# Run
export TMDB_API_KEY=your_key
npm start

Configuration

Set your TMDB API key as an environment variable:

export TMDB_API_KEY="your_api_key_here"

Or the MCP server will prompt for API key if not set.

Running

# With environment variable
TMDB_API_KEY=your_key npm start

# Or export first
export TMDB_API_KEY=your_key
npm start

MCP Client Configuration

Add to your MCP config:

{
  "mcpServers": {
    "tmdb": {
      "command": "node",
      "args": ["node_modules/@ryanxili/tmdb-mcp/index.js"],
      "env": {
        "TMDB_API_KEY": "your_api_key"
      }
    }
  }
}

Or with npx (requires internet):

{
  "mcpServers": {
    "tmdb": {
      "command": "npx",
      "args": ["-y", "@ryanxili/tmdb-mcp"],
      "env": {
        "TMDB_API_KEY": "your_api_key"
      }
    }
  }
}

Implementation Note

This MCP server uses curl instead of native fetch for API requests because:

• Node.js built-in fetch does not respect system proxy settings (http_proxy/https_proxy)
• curl automatically uses proxy environment variables, ensuring compatibility with various network environments

Available Tools

Language

All results are returned in Chinese (zh-CN) by default.

Get TMDB API Key

1. Go to TMDB
2. Create an account
3. Go to Settings > API
4. Generate your API key

License

MIT