Trakt

🚀 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。