项目简介

MCP Trakt 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在弥合 AI 语言模型与 Trakt.tv 娱乐数据平台之间的鸿沟。通过此服务器，AI 模型可以访问 Trakt.tv 的实时娱乐数据，包括热门节目、电影以及用户的个人观影历史。这使得 AI 能够提供更丰富的上下文信息，例如推荐电影和电视剧、查询观看记录、甚至记录当前观看状态。

主要功能点

公共 Trakt 数据访问：
- 获取热门和流行电影、电视剧列表。
- 查询最受喜爱、播放次数最多、观看人数最多的内容。
- 获取 Trakt 社区的实时数据，例如当前的流行趋势。
个人 Trakt 数据访问 (需要用户认证)：
- 查看个人观看过的电视剧和电影的完整列表。
- 获取上次观看日期和观看次数等详细信息。
- 将当前观看的节目或电影签到 Trakt，记录观看进度。
节目和电影搜索：
- 根据关键词搜索节目和电影，获取详细信息和 Trakt ID。
用户认证：
- 使用 Trakt 设备授权流程进行安全的用户身份验证。
- 安全存储用户认证令牌，方便后续访问个人数据。
工具和资源：
- 提供丰富的 MCP 资源 (Resources) 用于获取各种 Trakt 数据。
- 提供多种 MCP 工具 (Tools) 用于执行特定操作，例如数据检索、搜索和签到。

安装步骤

克隆仓库

git clone https://github.com/wwiens/trakt_mcpserver.git
cd trakt_mcpserver

安装依赖

pip install -r requirements.txt

配置环境变量

复制 '.env.example' 文件并重命名为 '.env'，然后编辑 '.env' 文件，填入您的 Trakt API 凭据。您需要在 Trakt.tv 开发者后台创建一个应用以获取 'TRAKT_CLIENT_ID' 和 'TRAKT_CLIENT_SECRET'。
```
cp .env.example .env
```
编辑 '.env' 文件，添加 Trakt API 凭据：
```
TRAKT_CLIENT_ID=your_client_id
TRAKT_CLIENT_SECRET=your_client_secret
```
运行服务器
```
python server.py
```
服务器默认在本地启动。

服务器配置

要将 MCP Trakt 服务器与 MCP 客户端（例如 Claude）连接，您需要提供以下配置信息。这是一个 JSON 格式的配置，您需要将其添加到 MCP 客户端的服务器配置中。

{
  "serverName": "Trakt MCP",
  "command": "python",
  "args": [
    "server.py"
  ]
}

配置参数说明:

'serverName': 服务器名称，设置为 "Trakt MCP"。
'command': 启动服务器的命令，这里使用 'python' 解释器。
'args': 传递给 'python' 命令的参数，指定运行 'server.py' 文件。

基本使用方法

安装 MCP 服务器到 Claude Desktop (或其他 MCP 客户端)

在终端中使用 'mcp install server.py' 命令可以将服务器安装到 Claude Desktop。
与 Claude 交互

安装成功后，您可以向 Claude 提出与电影、电视剧相关的问题，例如：
- "现在有哪些热门电视剧？"
- "推荐一些本周流行的电影。"
- "这个月观看次数最多的电视剧是什么？"
- "显示我观看过的电视剧" (需要认证)
- "我上次看的是哪部电视剧？" (需要认证)
- "搜索类似《绝命毒师》的电视剧"
- "将我签到《绝命毒师》第二季第五集" (使用剧名)
- "将我签到 ID 为 1388 的电视剧第一季第三集，并分享到 Twitter" (使用 ID)
Claude 将使用 MCP Trakt 服务器来获取 Trakt.tv 的实时数据，并根据您的指令执行相应的操作。对于需要用户认证的功能（例如查看个人观看记录、签到），服务器会自动引导您完成 Trakt 身份验证流程。

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息