themoviedb

This MCP server provides a wrapper over The Movie Database (TMDb) API. It exposes an MCP interface with functions such as popular_movie, now_playing_movie, movie_detail, cast_list, and search_movie. The server expects a TMDb API token via the token environment variable and serves its MCP endpoints at http://localhost:3000/mcp. Clients can connect to this endpoint using Server-Sent Events (SSE) to retrieve data for each function, as demonstrated by the example client configuration in the README. The available functions cover a range of movie data: popular_movie fetches popular titles, now_playing_movie returns currently released titles, movie_detail provides details for a specific movie, cast_list returns cast information for a movie, and search_movie enables querying the TMDb catalog. Each function supports relevant parameters like language, page, movie_id, year, and query to tailor the results.

Prerequisites:

• Node.js or Bun runtime (the server in the README is started with bun app.ts, but this MCP config uses node to run app.ts in this setup)
• Access to The Movie Database API token

Installation steps:

1. Install dependencies (if using npm/yarn):

npm install

2. Create a .env file in the project root and add your TMDb token:

token=YOUR_API_TOKEN

3. Ensure the MCP server file exists (as referenced by app.ts) and is configured to read the token from the environment or .env via a dotenv mechanism.
4. Start the server:

# Using Bun as indicated in the README (if bun is installed)
bun app.ts
# Or using Node if app.ts is compatible (as in mcp_config):
node app.ts

5. Verify the server is running at http://localhost:3000/mcp and connect from your MCP client as shown in the README.

Notes and tips:

• Ensure the TMDb API token is loaded into the environment (token in .env or process.env.token) before starting the server.
• The server listens on port 3000 by default; if you deploy behind a reverse proxy or inside a container, adjust the port accordingly and update the client URL.
• The MCP client example uses SSE; configure your client to handle event streams from http://localhost:3000/mcp.
• If you face authentication errors, double-check that the token is correct and that the environment variable name matches what the server expects.
• The supported functions are: popular_movie, now_playing_movie, movie_detail, cast_list, search_movie. Each function accepts specific parameters (see README) and should be included in your MCP requests accordingly.