TV推荐MCP服务器 🚀

基本能力

产品定位

TV推荐MCP服务器是一个专注于美剧推荐和信息查询的服务，旨在通过自然语言交互为用户提供个性化的剧集发现体验。

核心功能

• 按类型推荐剧集 (get_recommendations_by_genre)
• 查找相似剧集 (get_similar_shows)
• 获取剧集详细信息 (get_show_details)
• 查询剧集观看渠道 (get_watch_providers)
• 高级剧集发现 (discover_shows)
• 查询演员信息及其作品 (get_actor_details_and_credits, find_shows_by_actor, get_recommendations_by_actor)
• 查询热门与趋势剧集 (get_popular_shows, get_trending_shows)
• 查询剧集预告片与视频 (get_show_videos)
• 查询剧集用户评论 (get_show_reviews)

适用场景

• 发现新剧集
• 基于喜爱的演员探索
• 精确筛选剧集
• 相似内容探索

工具列表

1. get_recommendations_by_genre - 按类型获取剧集推荐
2. get_similar_shows - 获取与指定剧集相似的推荐
3. get_show_details - 获取指定剧集的详细信息
4. get_watch_providers - 查询特定剧集在指定国家/地区的观看渠道
5. discover_shows - 高级剧集发现，支持多种条件组合
6. find_shows_by_actor - 查找演员参演的剧集
7. get_recommendations_by_actor - 获取演员推荐的剧集
8. get_actor_details_and_credits - 获取演员详细信息及其参演的剧集列表
9. get_popular_shows - 获取当前最热门的剧集
10. get_trending_shows - 获取近期趋势剧集
11. get_show_videos - 获取指定剧集的预告片和相关视频
12. get_show_reviews - 查看其他用户对特定剧集的评论

常见问题解答

• API Key管理：TMDb API密钥不应硬编码在源代码中或提交到版本控制系统，仅通过环境变量使用。
• 输入验证：建议在工具实现中进行基本的输入参数验证。
• 速率限制：请注意TMDb API的速率限制。

使用教程

使用依赖

1. 需要Node.js环境
2. 需要TMDb API密钥（可在TMDb网站申请）

安装教程

1. 从NPM安装 bash npm install -g tv-recommender-mcp-server

2. 配置环境变量 bash export TMDB_API_KEY=your_api_key_here

3. 运行服务器 bash tv-recommender-mcp-server

或者克隆仓库：

1. 克隆仓库 bash git clone <仓库地址> cd tv-recommender-mcp-server

2. 安装依赖 bash npm install

3. 配置环境变量

4. 复制.env-example为.env

5. 将TMDb API密钥填入.env文件的TMDB_API_KEY字段

6. 构建并运行项目 bash npm run build npm start

调试方式

1. 启动开发模式 bash npm run dev

2. 在Cursor中配置MCP服务器

3. 创建或编辑.cursor/mcp.json文件
4. 配置服务器信息和环境变量

5. 保存后Cursor会自动检测并加载此MCP服务器

6. 查看日志

7. 在Cursor的开发者工具中（按Cmd+Option+I打开）查看控制台输出
8. 通过环境变量启用调试模式："DEBUG=mcp:*,npx tv-recommender-mcp-server"

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。