What2watch MCP

🚀 What2Watch MCP

赋予你的人工智能娱乐发现的超能力

🚀 快速开始

通过Claude连接

1. 打开Claude → 设置 → 连接器
2. 添加自定义连接器：https://what2watch.live/sse
3. 使用电子邮件魔法链接进行身份验证
4. 提问：“今晚我该看什么？”

通过ChatGPT连接

1. 访问 chatgpt.com → 设置 → 应用与连接器
2. 在高级设置中启用开发者模式
3. 使用URL https://what2watch.live/sse 创建应用
4. 完成身份验证，开始探索！

✨ 主要特性

告别千篇一律的推荐，开始发现真正值得一看的内容。普通的人工智能助手会搜索网络，返回2023年那些“Netflix热门”列表。而 What2Watch MCP 可直接连接到你的人工智能，让它能够获取以下内容：

• 1000多个频道的实时电视节目表（ABC、CBS、NBC、FOX、ESPN、CNN、HBO、AMC等）
• 免费流媒体（FAST）频道（Pluto TV、Tubi、Freevee、Roku Channel、Peacock Free、Samsung TV+、Xumo）
• 所有主流SVOD服务（Netflix、Prime Video、Disney+、Hulu、HBO Max、Apple TV+、Paramount+）
• 真正个性化的推荐，基于你的心情、品味和可用时间
• “惊喜推荐”模式，发现你自己永远找不到的隐藏佳作

真实数据，实时更新，真正个性化。

📦 安装指南

文档中未提及具体安装步骤，此部分跳过。

💻 使用示例

基础用法

寻找观看内容

用户：我想看一些黑暗、烧脑的内容，类似《真探》那种

人工智能：使用 get_recommendation，设置 mood="thought-provoking"，liked_media=["True Detective"]

根据你对《真探》的喜爱，以下是一些黑暗、烧脑的推荐：

1. 《心灵猎人》（Netflix） - 评分8.6/10 - FBI特工采访连环杀手
2. 《利器》（HBO Max） - 评分8.1/10 - 记者回到家乡
3. 《谋杀》（Hulu） - 评分8.3/10 - 侦探调查一起谋杀案 ...

查看直播电视节目

用户：今晚ESPN有什么节目？

人工智能：使用 get_schedule，设置 channels=["espn"]，time_range="tonight"

以下是今晚ESPN的节目安排：

• 晚上7:00 - NBA篮球：湖人vs凯尔特人
• 晚上10:00 - 体育中心
• 晚上11:00 - NFL直播 ...

发现隐藏佳作

用户：给我推荐一些我可能从未听说过的佳作

人工智能：使用 get_recommendation，设置 surprise_me=true

以下是一些大多数人还未发现的隐藏佳作：

1. 《熊家餐馆》（Hulu） - 评分8.6/10 - 一位厨师回来经营家族三明治店
2. 《人生切割术》（Apple TV+） - 评分8.7/10 - 办公室员工的记忆被手术分割 ...

高级用法

What2Watch MCP提供了6个强大的工具用于娱乐发现。

get_recommendation

根据你的偏好获取个性化的电影和电视节目推荐。

interface GetRecommendationParams {
  // 位置与语言
  location?: string;              // 国家代码（默认："US"）
  languages?: string[];           // 首选语言 ["en", "es"]

  // 用户资料
  gender?: string;                // 用户性别
  age_group?: string;             // "kids" | "teenager" | "young adult" | "adult" | "senior"

  // 平台
  platforms?: string[];           // ["netflix", "prime", "disney_plus", "hulu", "hbo_max", "apple_tv_plus"]
  channels?: string[];            // 有线电视/线性电视频道

  // 品味偏好
  liked_media?: string[];         // 喜欢的媒体标题 ["Breaking Bad", "The Wire"]
  disliked_media?: string[];      // 想要避开的标题
  watched_media?: string[];       // 已经看过的（结果中排除）

  // 过滤器
  media_type?: string;            // "movie" | "series" | "documentary"
  genre?: string;                 // "comedy" | "drama" | "action" | "thriller" | "sci-fi" | "horror" | "romance"
  mood?: string;                  // "relaxing" | "exciting" | "thought-provoking"
  watch_time?: string;            // "now" | "tonight" | "later"

  // 探索
  surprise_me?: boolean;          // 发现被低估的隐藏佳作（默认：false）
  limit?: number;                 // 最大结果数1 - 10（默认：5）
}

示例查询：

• “我该看什么？”
• “推荐类似《绝命毒师》的内容”
• “我想看轻松的喜剧”
• “给我推荐一些隐藏佳作”

search_content

按标题、演员、导演或关键词搜索电影和节目。

interface SearchContentParams {
  keywords?: string;              // 文本搜索（标题、演员姓名、剧情关键词）
  genres?: string[];              // 按多个类型过滤
  min_rating?: number;            // 最低IMDB评分0 - 10（例如：7.5）
  year_from?: number;             // 发行年份开始（例如：2020）
  year_to?: number;               // 发行年份结束（例如：2024）
  location?: string;              // 国家代码（默认："US"）
  languages?: string[];           // 首选语言
  platforms?: string[];           // 流媒体服务过滤
  liked_media?: string[];         // 提升类似内容的排名
  disliked_media?: string[];      // 想要避开的标题
  watched_media?: string[];       // 已经看过的（排除）
  media_type?: string;            // "movie" | "series" | "episode" | "documentary"
  genre?: string;                 // 单个类型过滤
  mood?: string;                  // "relaxing" | "exciting" | "thought-provoking"
  limit?: number;                 // 最大结果数1 - 10（默认：5）
}

示例查询：

• “查找汤姆·汉克斯的电影”
• “Netflix上评分高于8的动作电影”
• “2020 - 2024年的科幻节目”
• “搜索《沙丘》”

get_content_details

获取特定电影或电视节目的完整详细信息。

interface GetContentDetailsParams {
  content_id: string;             // 搜索/推荐结果中的ID
}

返回值：包括剧情、演员、工作人员、评分、预告片和流媒体可用性的完整详细信息。 示例查询：

• “告诉我更多关于《盗梦空间》的信息”
• “《熊家餐馆》讲的是什么？”
• “《人生切割术》的主演是谁？”
• “我在哪里可以看《奥本海默》？”

get_schedule

获取电视广播节目表 - 现在或稍后直播电视上正在播放的内容。

interface GetScheduleParams {
  time_range?: string;            // "now"（接下来2小时） | "tonight"（下午6点 - 午夜） | "today" | "tomorrow"
  channels?: string[];            // 按频道过滤 ["hbo", "nbc", "espn", "abc", "cbs", "fox"]
  location?: string;              // 国家代码（默认："US"）
  liked_media?: string[];         // 提升类似内容
  disliked_media?: string[];      // 想要避开的标题（排除）
  watched_media?: string[];       // 已经看过的（排除）
  media_type?: string;            // "movie" | "series" | "sports" | "news" | "documentary"
  genre?: string;                 // "drama" | "comedy" | "sports" | "news"
  genres?: string[];              // 多个类型 ["sports", "action"]
  min_rating?: number;            // 最低IMDB评分0 - 10
  limit?: number;                 // 最大结果数1 - 10（默认：5）
}

示例查询：

• “今晚电视上有什么节目？”
• “现在ESPN正在播什么？”
• “今晚HBO上的电影”
• “明天电视上的体育节目”

get_trending

查看当前流行和热门的内容。

interface GetTrendingParams {
  location?: string;              // 国家代码（默认："US"）
  platforms?: string[];           // 按流媒体服务过滤
  liked_media?: string[];         // 用于参考/个性化设置
  disliked_media?: string[];      // 想要避开的标题（排除）
  watched_media?: string[];       // 已经看过的（排除）
  media_type?: string;            // "movie" | "series"
  genre?: string;                 // 按类型过滤
  time_window?: string;           // "day" | "week" | "month"（默认：所有时间）
  limit?: number;                 // 最大结果数1 - 10（默认：5）
}

示例查询：

• “当前流行什么？”
• “Netflix上流行什么？”
• “本周热门电影”
• “大家都在看什么？”

get_available_sources

列出所有支持的流媒体平台和电视频道。

interface GetAvailableSourcesParams {
  location?: string;              // 国家代码（默认："US"）
  include_channels?: boolean;     // 包括有节目表的电视频道（默认：true）
  include_platforms?: boolean;    // 包括流媒体平台（默认：true）
}

返回值：按类型（订阅、免费、租赁、购买）分组的平台及其内容数量；具有节目表可用性的电视频道。 示例查询：

• “你们支持哪些平台？”
• “有哪些流媒体服务可用？”
• “哪些频道有电视节目表？”

📚 详细文档

What2Watch MCP提供了19个预构建的提示，用于常见的娱乐查询。

探索提示

搜索提示

热门提示

电视节目表提示

场合相关提示

平台提示

响应格式

所有工具返回结构化响应，包含：

interface ToolResponse {
  results: ContentItem[];         // 电影/节目的数组
  total_count: number;            // 找到的总匹配数
  filters_applied: object;        // 使用了哪些过滤器
  next_steps: string[];           // 上下文相关的后续建议
}

interface ContentItem {
  id: string;                     // 唯一标识符
  title: string;                  // 显示标题
  type: "movie" | "series";       // 内容类型
  year: number;                   // 发行年份
  rating: number;                 // IMDB评分0 - 10
  genres: string[];               // 类型标签
  plot: string;                   // 简要描述
  runtime?: number;               // 时长（分钟，适用于电影）
  seasons?: number;               // 季数（适用于系列节目）
  availability: Availability[];   // 观看渠道
}

interface Availability {
  platform: string;               // "netflix", "hulu", 等
  platform_name: string;          // "Netflix", "Hulu", 等
  type: "subscription" | "free" | "rent" | "purchase";
  link?: string;                  // 直接观看链接
  price?: number;                 // 租赁/购买价格
}

支持的平台

流媒体服务（SVOD）

Netflix、Amazon Prime Video、Disney+、Hulu、HBO Max、Apple TV+、Paramount+、Peacock、AMC+、Starz、Showtime、Britbox、Crunchyroll等。

免费流媒体（FAST）

Pluto TV、Tubi、Amazon Freevee、The Roku Channel、Peacock Free、Samsung TV Plus、Xumo、Plex等。

直播电视频道

ABC、CBS、NBC、FOX、ESPN、ESPN2、CNN、MSNBC、Fox News、HBO、Showtime、AMC、FX、TNT、TBS、USA、Bravo、HGTV、Food Network、Discovery、History、A&E、Lifetime、Comedy Central、MTV、VH1、BET、Nickelodeon、Disney Channel、Cartoon Network等1000多个频道。

🔧 技术细节

• 协议：模型上下文协议（MCP）
• 传输方式：服务器发送事件（SSE）
• 身份验证：带有PKCE的OAuth 2.1
• 端点：https://what2watch.live/sse

📄 许可证

本项目采用MIT许可证，详情请参阅 LICENSE 文件。

链接

• 实时服务器：https://what2watch.live
• MCP规范：https://modelcontextprotocol.io

让人工智能真正在娱乐领域发挥作用