Trakt

🚀 Trakt 統合 MCP サーバーガイド

このガイドでは、Trakt を MCP サーバーに統合する方法を説明します。Trakt を使用することで、映画やテレビ番組の視聴記録や統計情報を管理できます。

🚀 クイックスタート

📦 インストール

リポジトリのクローン

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

依存関係のインストール

pip install -r requirements.txt

環境の設定

.env ファイルをコピーして編集します。

cp .env.example .env

次に、.env ファイルに Trakt API の認証情報を追加します。

TRAKT_CLIENT_ID=your_client_id
TRAKT_CLIENT_SECRET=your_client_secret

サーバーの起動

python server.py

🛠️ 開発とテスト

MCP チェックツールを使用したテスト

mcp dev server.py

Claude Desktop へのインストール

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