🎬 MCP Trakt: Your AI's Gateway to Entertainment Data

基本能力

产品定位

MCP Trakt 是一个连接 AI 语言模型和 Trakt.tv API 的桥梁，旨在为 AI 提供实时娱乐数据和个人观看历史的访问能力。

核心功能

1. 公共 Trakt 数据访问：
2. 获取热门和流行的电视节目和电影
3. 发现最受欢迎、播放次数最多和观看次数最多的内容

4. 从 Trakt 全球社区获取实时数据

5. 个人 Trakt 数据访问：

6. 查看已观看的节目和电影
7. 获取每个节目的最后观看日期和观看次数
8. 检查当前观看的节目并标记为已观看

9. 搜索节目以获取其详细信息和 ID

10. 通用功能：

11. 通过 MCP 资源公开 Trakt API 数据
12. 提供获取实时娱乐信息的工具
13. 使 AI 模型能够提供个性化娱乐推荐

适用场景

• AI 助手提供实时娱乐推荐
• 个人观看历史管理和统计
• 社交媒体分享观看活动
• 娱乐内容搜索和发现

工具列表

1. 节目工具：
2. fetch_trending_shows：获取热门节目
3. fetch_popular_shows：获取流行节目

4. search_shows：按标题搜索节目

5. 电影工具：

6. fetch_trending_movies：获取热门电影

7. fetch_popular_movies：获取流行电影

8. 认证和用户工具：

9. start_device_auth：启动设备认证流程

10. fetch_user_watched_shows：获取用户观看的节目

11. 签到工具：

12. checkin_to_show：使用节目 ID 或标题签到

常见问题解答

1. 如何认证？

2. 服务器会自动启动认证流程，用户需要在浏览器中输入代码并授权。

3. 如何注销？

4. 使用 clear_auth 工具即可注销。

使用教程

使用依赖

1. 确保已安装 Python 和 pip

安装教程

1. 克隆仓库 bash git clone https://github.com/yourusername/mcp-trakt.git cd mcp-trakt

2. 安装依赖 bash pip install -r requirements.txt

3. 设置环境变量 bash cp .env.example .env 编辑 .env 文件添加 Trakt API 凭证： TRAKT_CLIENT_ID=your_client_id TRAKT_CLIENT_SECRET=your_client_secret

4. 运行服务器 bash python server.py

调试方式

1. 使用 MCP Inspector 测试 bash mcp dev server.py

2. 在 Claude Desktop 中安装 bash mcp install server.py

许可证

该项目遵循 MIT 开源许可条款。