README
🚀 What2Watch MCP
赋予你的人工智能娱乐发现的超能力
🚀 快速开始
通过Claude连接
- 打开Claude → 设置 → 连接器
- 添加自定义连接器:
https://what2watch.live/sse - 使用电子邮件魔法链接进行身份验证
- 提问:“今晚我该看什么?”
通过ChatGPT连接
- 访问 chatgpt.com → 设置 → 应用与连接器
- 在高级设置中启用开发者模式
- 使用URL
https://what2watch.live/sse创建应用 - 完成身份验证,开始探索!
✨ 主要特性
告别千篇一律的推荐,开始发现真正值得一看的内容。普通的人工智能助手会搜索网络,返回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"]根据你对《真探》的喜爱,以下是一些黑暗、烧脑的推荐:
- 《心灵猎人》(Netflix) - 评分8.6/10 - FBI特工采访连环杀手
- 《利器》(HBO Max) - 评分8.1/10 - 记者回到家乡
- 《谋杀》(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以下是一些大多数人还未发现的隐藏佳作:
- 《熊家餐馆》(Hulu) - 评分8.6/10 - 一位厨师回来经营家族三明治店
- 《人生切割术》(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个预构建的提示,用于常见的娱乐查询。
探索提示
| 提示 | 参数 | 描述 |
| ---- | ---- | ---- |
| what_to_watch | mood?, platforms?, media_type? | 当你“不知道看什么”时的首选提示 |
| surprise_me | genre? | 发现隐藏佳作和被低估的内容 |
| recommend_by_mood | mood(必填) | 匹配你当前的心情(轻松、刺激、有趣、黑暗等) |
| similar_to | title(必填), media_type? | 查找与你喜欢的内容相似的内容 |
搜索提示
| 提示 | 参数 | 描述 |
| ---- | ---- | ---- |
| find_title | title(必填) | 搜索特定的电影或节目 |
| find_by_actor | actor_name(必填), media_type? | 查找特定演员出演的内容 |
| find_by_genre | genre(必填), platforms? | 查找特定类型的内容 |
| recent_releases | media_type?, genre?, min_rating? | 查找去年的最新发行内容 |
热门提示
| 提示 | 参数 | 描述 |
| ---- | ---- | ---- |
| whats_trending | media_type? | 查看当前流行的内容 |
| trending_on_platform | platform(必填) | 查看特定服务上流行的内容 |
| top_rated | genre?, media_type? | 查找评分最高的内容 |
电视节目表提示
| 提示 | 参数 | 描述 |
| ---- | ---- | ---- |
| whats_on_tv | time_range? | 查看直播电视上正在播放的内容 |
| whats_on_channel | channel(必填), time_range? | 查看特定频道的节目表 |
场合相关提示
| 提示 | 参数 | 描述 |
| ---- | ---- | ---- |
| movie_night | group?, platforms? | 电影之夜的推荐(朋友、家人、约会) |
| family_friendly | platforms? | 适合全家观看的儿童友好型内容 |
| date_night | platforms? | 浪漫或适合约会的选择 |
| weekend_binge | genre?, platforms? | 周末适合一口气看完的精彩系列 |
| quick_watch | max_minutes? | 时间有限时的短内容 |
平台提示
| 提示 | 参数 | 描述 |
| ---- | ---- | ---- |
| available_platforms | - | 列出所有支持的流媒体服务和频道 |
| compare_platforms | title(必填) | 查找特定标题在哪些平台上可用 |
响应格式
所有工具返回结构化响应,包含:
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
让人工智能真正在娱乐领域发挥作用
微信扫一扫