TV推荐MCP服务器 🚀

by terryso

5 stars

274 downloads

Not rated

GitHub

Other

About

[English Version](README.en.md) # TV推荐MCP服务器 🚀 [![codecov](https://codecov.io/github/terryso/tv-recommender-mcp-server/graph/badge.svg?token=ZMF2J8D636)](https://codecov.io/github/terryso/tv-recommender-mcp-server) [![npm…

Details

Author: terryso
GitHub stars: 5
Downloads: 274
Categories: Other

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name TV推荐MCP服务器 🚀

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "tv\u63a8\u8350mcp\u670d\u52a1\u5668 \ud83d\ude80": {
            "TVRecommender": {
                "command": "env",
                "args": [
                    "TMDB_API_KEY=xxx",
                    "npx",
                    "-y",
                    "tv-recommender-mcp-server"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "tv\u63a8\u8350mcp\u670d\u52a1\u5668 \ud83d\ude80": {
            "TVRecommender": {
                "command": "env",
                "args": [
                    "TMDB_API_KEY=xxx",
                    "npx",
                    "-y",
                    "tv-recommender-mcp-server"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "tv\u63a8\u8350mcp\u670d\u52a1\u5668 \ud83d\ude80": {
            "TVRecommender": {
                "command": "env",
                "args": [
                    "TMDB_API_KEY=xxx",
                    "npx",
                    "-y",
                    "tv-recommender-mcp-server"
                ]
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "tv\u63a8\u8350mcp\u670d\u52a1\u5668 \ud83d\ude80": {
            "TVRecommender": {
                "command": "env",
                "args": [
                    "TMDB_API_KEY=xxx",
                    "npx",
                    "-y",
                    "tv-recommender-mcp-server"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "tv\u63a8\u8350mcp\u670d\u52a1\u5668 \ud83d\ude80": {
            "TVRecommender": {
                "command": "env",
                "args": [
                    "TMDB_API_KEY=xxx",
                    "npx",
                    "-y",
                    "tv-recommender-mcp-server"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "tv\u63a8\u8350mcp\u670d\u52a1\u5668 \ud83d\ude80": {
            "TVRecommender": {
                "command": "env",
                "args": [
                    "TMDB_API_KEY=xxx",
                    "npx",
                    "-y",
                    "tv-recommender-mcp-server"
                ]
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "tv\u63a8\u8350mcp\u670d\u52a1\u5668 \ud83d\ude80": {
            "TVRecommender": {
                "command": "env",
                "args": [
                    "TMDB_API_KEY=xxx",
                    "npx",
                    "-y",
                    "tv-recommender-mcp-server"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "tv\u63a8\u8350mcp\u670d\u52a1\u5668 \ud83d\ude80": {
            "TVRecommender": {
                "command": "env",
                "args": [
                    "TMDB_API_KEY=xxx",
                    "npx",
                    "-y",
                    "tv-recommender-mcp-server"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "tv\u63a8\u8350mcp\u670d\u52a1\u5668 \ud83d\ude80": {
            "TVRecommender": {
                "command": "env",
                "args": [
                    "TMDB_API_KEY=xxx",
                    "npx",
                    "-y",
                    "tv-recommender-mcp-server"
                ]
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "tv\u63a8\u8350mcp\u670d\u52a1\u5668 \ud83d\ude80": {
            "TVRecommender": {
                "command": "env",
                "args": [
                    "TMDB_API_KEY=xxx",
                    "npx",
                    "-y",
                    "tv-recommender-mcp-server"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "tv\u63a8\u8350mcp\u670d\u52a1\u5668 \ud83d\ude80": {
            "TVRecommender": {
                "command": "env",
                "args": [
                    "TMDB_API_KEY=xxx",
                    "npx",
                    "-y",
                    "tv-recommender-mcp-server"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "tv\u63a8\u8350mcp\u670d\u52a1\u5668 \ud83d\ude80": {
            "TVRecommender": {
                "command": "env",
                "args": [
                    "TMDB_API_KEY=xxx",
                    "npx",
                    "-y",
                    "tv-recommender-mcp-server"
                ]
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "tv\u63a8\u8350mcp\u670d\u52a1\u5668 \ud83d\ude80": {
            "TVRecommender": {
                "command": "env",
                "args": [
                    "TMDB_API_KEY=xxx",
                    "npx",
                    "-y",
                    "tv-recommender-mcp-server"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "tv\u63a8\u8350mcp\u670d\u52a1\u5668 \ud83d\ude80": {
            "TVRecommender": {
                "command": "env",
                "args": [
                    "TMDB_API_KEY=xxx",
                    "npx",
                    "-y",
                    "tv-recommender-mcp-server"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "tv\u63a8\u8350mcp\u670d\u52a1\u5668 \ud83d\ude80": {
            "TVRecommender": {
                "command": "env",
                "args": [
                    "TMDB_API_KEY=xxx",
                    "npx",
                    "-y",
                    "tv-recommender-mcp-server"
                ]
            }
        }
    }
}

From the repository

{
  "mcpServers": {
    "TVRecommender": {
      "command": "env",
      "args": [
        "TMDB_API_KEY=xxx",
        "npx",
        "-y",
        "tv-recommender-mcp-server"
      ]
    }
  }
}

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "tv\u63a8\u8350mcp\u670d\u52a1\u5668 \ud83d\ude80": {
            "TVRecommender": {
                "command": "env",
                "args": [
                    "TMDB_API_KEY=xxx",
                    "npx",
                    "-y",
                    "tv-recommender-mcp-server"
                ]
            }
        }
    }
}

McpServers

{
    "TVRecommender": {
        "command": "env",
        "args": [
            "TMDB_API_KEY=xxx",
            "npx",
            "-y",
            "tv-recommender-mcp-server"
        ]
    }
}

TV推荐MCP服务器 🚀

NPM Downloads

> 基于TMDb API的美剧推荐MCP服务器，提供按类型推荐、相似剧集推荐和剧集详情功能。

项目描述

本项目是一个基于MCP(Model Context Protocol)的服务器，专门用于提供全面的美剧推荐和信息查询服务。服务器通过标准输入/输出(stdio)与支持MCP的客户端通信，并通过调用TMDb(The Movie Database) API获取数据。服务覆盖从剧集发现、详情查询到观看渠道、演员信息、用户评论等多方面功能，为用户提供一站式剧集探索体验。

项目背景与愿景

大型语言模型（LLM）在理解和生成文本方面表现出色，但在提供实时、个性化的美剧推荐方面存在局限性（如知识截止、缺乏用户偏好理解）。用户期望通过自然语言交互获得更精准、更及时的推荐，而现有LLM难以完全满足此需求。本项目旨在通过Model Context Protocol (MCP) Server扩展LLM的能力，解决这一痛点，抓住提供更智能影视发现体验的机会。

愿景： 让用户能够通过与LLM的自然对话，无缝地发现、了解并获取个性化、实时、可解释的美剧推荐，将LLM变为强大的个人娱乐顾问。

目标用户

主要目标用户是熟悉并使用支持MCP的LLM客户端（如Claude Desktop）的个人用户。他们是美剧爱好者，对通过AI获取信息持开放态度，并希望以更自然、交互的方式发现符合口味的新剧集。

系统架构

此MCP服务器采用模块化设计，具有明确的关注点分离。服务器初始化MCP框架，注册各种推荐工具，并使用TMDb客户端与TMDb API交互。配置设置（特别是TMDb API密钥）通过环境变量管理。

高级架构图

flowchart TD
    A["MCP客户端<br>(LLM工具)"] -- "MCP请求<br>(stdio)" --> B
    
    subgraph "服务器架构"
    B["MCP核心<br>(stdio)"] --> C["工具路由器"]
    C --> D["工具实现层"]
    D --> E["TMDb服务客户端"]
    D --> F["工具辅助功能<br>(如类型映射)"]
    E -- "HTTP请求" --> G["TMDb API"]
    D --> H["日志系统"]
    E --> H
    end
    
    G -- "HTTP响应" --> E
    B -- "发送响应" --> A

核心组件

- MCP服务器实现：服务器基于Model Context Protocol SDK for TypeScript构建，提供工具注册和客户端通信的基础。
- TMDb客户端：负责与TMDb API的所有交互，处理认证、构建API请求并处理响应。
- 推荐工具：服务器公开各种工具，提供与电视节目发现和信息检索相关的特定功能。

功能与路线图 (Features & Roadmap)

以下是本项目的完整功能列表及开发状态 (基于 .ai 目录下的用户故事):

Epic 1: 核心推荐工具 MVP (Core Recommendation Tools MVP)
- [x] MCP 服务器基础设置与 API 集成 (MCP Server Setup & API Integration) (story-1-1-setup-integration.md)
- [x] 按类型推荐剧集 (Recommend Shows by Genre) (story-1-2-recommend-genre.md) - 工具: get_recommendations_by_genre
- [x] 查找相似剧集 (Find Similar Shows) (story-1-3-recommend-similar.md) - 工具: get_similar_shows
- [x] 获取剧集详情 (Get Show Details) (story-1-4-show-details.md) - 工具: get_show_details

Epic 2: 增强与扩展 (Enhancements & Expansion)
- [ ] 基于关键词/主题发现 (Keyword/Theme Based Discovery) (story-2-1-keyword-discovery.md)
- [ ] 发现演员早期作品 (Early Actor Works Discovery) (story-2-2-early-works.md)
- [ ] 详细的单集信息与互动 (Detailed Episode Information & Interaction) (story-2-3-episode-details.md)
- [ ] 内容聚合(按平台/网络/公司) (Provider/Network/Company Content Aggregation) (story-2-4-provider-aggregation.md)
- [x] 查询演员信息及其作品 (Query Actor Information and Credits) (story-2-5-actor-info.md) - 工具: get_actor_details_and_credits, find_shows_by_actor, get_recommendations_by_actor
- [x] 高级剧集发现 (Advanced Show Discovery) (story-2-6-advanced-discovery.md) - 工具: discover_shows
- [x] 查询热门与趋势剧集 (Query Popular & Trending Shows) (story-2-7-popular-trending.md) - 工具: get_popular_shows, get_trending_shows
- [x] 查询剧集用户评论 (Query Show User Reviews) (story-2-8-reviews-ratings.md) - 工具: get_show_reviews
- [x] 查询剧集预告片与视频 (Query Show Trailers & Videos) (story-2-9-trailers.md) - 工具: get_show_videos
- [x] 查询剧集观看渠道 (Query Show Watch Providers) (story-2-10-watch-providers.md) - 工具: get_watch_providers

Epic 3: 个性化与集成 (Personalization & Integration)
- [ ] 智能追剧进度管理 (Smart Watch Progress Management) (story-3-1-watch-progress.md)

Epic 4: 可视化与探索 (Visualization & Exploration)
- [ ] 可视化系列/宇宙探索 (Visual Franchise/Universe Exploration) (story-4-1-franchise-visualization.md)

技术栈

- 语言: TypeScript
- 运行时环境: Node.js
- MCP SDK: @modelcontextprotocol/sdk
- 类型验证: zod
- HTTP客户端: axios
- 外部API: TMDb (The Movie Database)
- 环境变量管理: dotenv

快速开始

使用npx可以快速运行服务器，无需安装：

```bash

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

TV推荐MCP服务器 🚀

About

Details

Jump to

Setting up with Highlight

Setting up with Cursor

JSON

JSON

JSON

Setting up with Claude Desktop

JSON

JSON

JSON

Setting up with Windsurf

JSON

JSON

JSON

Setting up with Cline

JSON

JSON

JSON

Setting up with Goose

JSON

JSON

JSON

From the repository

Claude Desktop / Cursor

McpServers

TV推荐MCP服务器 🚀

项目描述

项目背景与愿景

目标用户

系统架构

高级架构图

核心组件

功能与路线图 (Features & Roadmap)

技术栈

快速开始

Install

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

TV推荐MCP服务器 🚀

项目描述

项目背景与愿景

目标用户

系统架构

高级架构图

核心组件

功能与路线图 (Features & Roadmap)

技术栈

快速开始

Install

More like this

Sequential Thinking

Filesystem

EverArt

Google Drive

Reactive Resume

FastMCP v2 🚀