Overseerr MCP Server

🚀 Overseerr 管理コンソールプロトコル (MCP)

Overseerrに統合されたModel Context Protocol (MCP)です。Claude AIを通じて自然言語でメディアリクエストシステムと対話できます。このサーバーを使うと、会話形式の言語で映画やテレビ番組を検索し、メディアリクエストを送信し、Overseerrインスタンスを管理できます。

🚀 クイックスタート

このサーバーをClaudeと一緒に使って行える対話の例を紹介します。

あなた: 最近のSF映画を探せますか？
Claude: 最近のSF映画を検索します...
[overseerr:searchを使って最近のSF映画を検索]

あなた: これはいいですね！2本目をリクエストできますか？
Claude: その映画をリクエストします...
[overseerr:requestを使ってメディアリクエストを送信]

あなた: 料理に関するテレビ番組はありますか？
Claude: 料理に関連するテレビ番組を検索します...
[overseerr:searchとtype='tv'を使って料理系の番組を検索]

✨ 主な機能

メディア検索

• 映画、テレビ番組、人物を検索できます。
• メディアに関する詳細情報を取得できます。内容は以下の通りです。
  • タイトルと公開日
  • あらすじ
  • 利用可能状態
  • リクエスト状態
• メディアタイプ（映画/テレビ番組/人物）で絞り込みができます。
• 自然言語でのクエリが可能です（例：「最近のSF映画を探す」や「『断裂点』のような番組を検索」）。

メディアリクエスト

• 映画やテレビ番組をリクエストできます。
• テレビ番組の場合は具体的なシーズンを指定できます。
• リクエストの状態を追跡できます。
• リクエストの更新通知を受け取れます。
• 自然言語でのリクエストが可能です（例：「最新のバットマン映画をリクエスト」や「『Succession』を視聴リストに追加」）。

統合

• stdioトランスポートを通じたClaude AIとのシームレスな統合が可能です。
• Overseerrインスタンスとリアルタイムでやり取りできます。
• 安全なAPIキー管理が行われます。
• レート制限とエラー処理が実装されています。
• 環境変数を使って簡単に設定できます。

📦 インストール

前提条件

• Node.js
• pnpm
• Claude Desktop
• Overseerrインスタンス

手順

1. 依存関係をインストールします。

pnpm install

2. プロジェクトをビルドします。

pnpm build

3. 環境を設定します。

# テンプレートをコピー
cp .env.template .env

# .envを自分の値で編集
OVERSEERR_URL=your_overseerr_url
OVERSEERR_API_KEY=your_api_key

4. サーバーを起動します。

pnpm start

🔧 技術詳細

環境変数

• OVERSEERR_URL：あなたのOverseerrインスタンスのURLです。
• OVERSEERR_API_KEY：あなたのOverseerr APIキーです。

エラー処理

サーバーには強力なエラー処理が実装されています。

• 意味のあるメッセージを持つAPIエラー
• レート制限保護
• リクエスト検証
• 接続エラーの回復

🤝 コントリビューションガイド

1. リポジトリをフォークします。
2. 機能ブランチを作成します。
3. 変更をコミットします。
4. ブランチにプッシュします。
5. Pull Requestを作成します。

📄 ライセンス

MITライセンスの下で提供されています。