Overview
什么是TV推荐MCP服务器 🚀?
基于TMDb API的美剧推荐MCP服务器，通过Model Context Protocol为LLM客户端提供按类型推荐、相似剧集推荐、剧集详情查询等功能。主要面向熟悉支持MCP的客户端（如Claude Desktop）的美剧爱好者，帮助他们通过自然语言交互发现和探索剧集。
如何用TV推荐MCP服务器 🚀?
通过npx快速运行：设置TMDB_API_KEY环境变量后执行npx tv-recommender-mcp-server。也可全局安装或克隆仓库后构建。在Cursor中需配置.cursor/mcp.json文件并指定命令和环境变量。服务器通过stdio与MCP客户端通信。
TV推荐MCP服务器 🚀的主要功能
- 按类型推荐剧集（
get_recommendations_by_genre） - 查找相似剧集（
get_similar_shows） - 获取剧集详情（
get_show_details） - 查询演员信息及作品（
get_actor_details_and_credits等） - 高级剧集发现（
discover_shows，支持多种条件组合） - 查询观看渠道、预告片、用户评论（
get_watch_providers等）
TV推荐MCP服务器 🚀的使用场景
- 发现新剧集：通过热门/趋势剧集入门，查看详情、预告片和观看渠道
- 基于喜爱的演员探索：查询演员作品，获取演员推荐，查看其他观众评价
- 精确筛选剧集：使用
discover_shows按类型、评分、年份、播放平台等条件查找 - 相似内容探索：看完一部剧后，用
get_similar_shows寻找风格类似的其他剧集
关于TV推荐MCP服务器 🚀的常见问题
如何获取TMDb API密钥？
在TMDb（The Movie Database）官方网站注册并申请免费的API密钥，之后通过环境变量TMDB_API_KEY配置。
服务器需要什么运行环境？
需要Node.js运行时环境（版本≥14），通过npm或npx安装运行。无需额外数据库或容器。
数据来源是什么？
所有剧集数据、演员信息、评论、观看渠道等均通过TMDb API获取，服务器不存储任何数据。
服务器支持HTTP或WebSocket传输吗？
不支持。服务器通过标准输入输出（stdio）与支持MCP的客户端通信，如Claude Desktop、Cursor等。
使用TMDb API是否有速率限制？
是的，需注意TMDb API的速率限制。开发者在未来迭代中可考虑实现重试逻辑或缓存机制。
