🚀 Trakt 集成 MCP 服务器指南

本指南将帮助你完成 Trakt 与 MCP 服务器的集成，实现对 Trakt 数据的便捷访问和管理。

🚀 快速开始

按照以下步骤，你可以轻松完成 Trakt 集成 MCP 服务器的安装与配置。

📦 安装指南

克隆仓库

将项目仓库克隆到本地，并进入项目目录：

git clone https://github.com/yourusername/mcp-trakt.git
cd mcp-trakt

安装依赖项

使用 pip 安装项目所需的依赖项：

pip install -r requirements.txt

配置环境

复制 .env.example 文件并重命名为 .env，然后编辑 .env 文件，添加你的 Trakt API 凭据：

cp .env.example .env

在 .env 文件中添加以下内容：

TRAKT_CLIENT_ID=your_client_id
TRAKT_CLIENT_SECRET=your_client_secret

启动服务器

运行以下命令启动服务器：

python server.py

🛠️ 开发与测试

使用 MCP 检查工具进行测试

使用 MCP 检查工具对 server.py 进行测试：

mcp dev server.py

在 Claude Desktop 中安装

在 Claude Desktop 中安装 server.py：

mcp install server.py

💻 使用示例

你可以向 Claude 提出以下问题，Claude 将利用此 MCP 服务器为您提供实时的 Trakt 数据：

• "哪些节目正在流行？"
• "你能推荐一些热门电影吗？"
• "这个月有哪些观看量最高的电视剧？"
• "显示我看过的所有节目"（需要身份验证）
• "上次我看的最后一部剧是什么？"（需要身份验证）
• "显示我看过的所有电影"（需要身份验证）
• "上次我看的最后一部电影是什么？"（需要身份验证）
• "搜索类似'Breaking Bad'的电视剧"
• "签到当前正在观看的 Breaking Bad 第 2 季第 5 集"（使用标题）
• "签到 Breaking Bad 第 1 季第 3 集，并分享到 Twitter"（使用 ID）

✨ 主要特性

核心功能

1. 设备认证流程：

   • 请求用户数据时自动触发身份验证。
   • 收到代码和链接后，访问浏览器完成授权。
   • 授权完成后通知 Claude，然后获取个人数据。
   • 认证令牌会安全存储以备将来使用。

2. 用户数据访问：

   • 查看完整的观看记录（剧集和电影）。
   • 获取每部作品的最后观看时间。
   • 统计每部作品的观看次数。
   • 跟踪当前观看进度并进行签到。
   • 记录个人观看统计数据。

3. 社交分享：

   • 签到时可选择在 Twitter、Mastodon 或 Tumblr 上分享。

未来发展

• 扩展身份验证功能以访问更多个人数据。
• 添加即将上映剧集的日历提醒。
• 支持自动跟踪观看进度（Scrobbling）。
• 根据观看历史提供个性化推荐。
• 增加电影搜索功能。
• 扩展支持更多的社交平台。

📄 许可证

本项目采用 MIT License。