tv-recommender-mcp-server

tv-recommender-mcp-server

2
entertainment_and_mediaai_chatbot

The TV Recommender MCP Server is an MCP-based server that offers in-depth TV show recommendations and information retrieval using TMDb API. It targets users who love TV shows and use AI-supported conversational tools to explore and personalize their viewing experiences. The server emphasizes real-time, personalized recommendations through natural language dialogue with LLMs.

TV Recommender MCP Server 🚀

A TV show recommendation MCP server based on the TMDb API, offering recommendations by genre, similar shows, and show details.

Project Description

This project is an MCP (Model Context Protocol) server designed to provide comprehensive TV show recommendations and information query services. The server communicates with MCP-supported clients via standard input/output and retrieves data using the TMDb (The Movie Database) API. It offers a one-stop experience for users to discover, get details, and explore viewing options, actor information, and user reviews.

Background

Large Language Models (LLMs) have limitations in providing real-time, personalized TV recommendations. This project aims to enhance the capabilities of LLMs through the MCP server to offer smarter TV show discovery experiences.

Target Users

Personal users who are familiar with using MCP-supported LLM clients and who love TV shows while adopting AI information retrieval methods.

Features & Roadmap

  • Core Recommendation Tools MVP: Basic MCP server setup, genre-based recommendations, similar show search, and show details retrieval.
  • Enhancements & Expansion: Include keyword-based discovery, actor works exploration, and user reviews.
  • Personalization & Integration: Smart watch progress management.
  • Visualization & Exploration: Explore visual franchises/universes.

Tech Stack

  • Language: TypeScript
  • Runtime: Node.js
  • MCP SDK: @modelcontextprotocol/sdk
  • Type Validation: zod
  • HTTP Client: axios

Quick Start

Set the TMDb API key and run the server using npx:

  1. Export TMDb API Key as an environment variable.
  2. Start the server using npx tv-recommender-mcp-server.

Installation

  • Install via NPM, configure environment variables, and run the server.
  • Alternatively, clone the repository and set up dependencies manually.