Jellyfin MCP Server

Jellyfin MCP サーバープラグイン

Model Context Protocol（MCP）を通じて、Jellyfin サーバーを AI アシスタントに公開する Jellyfin プラグインです。Claude などのアシスタントは、ライブラリの検索や閲覧、視聴中の内容の確認、デバイスでの再生操作、プレイリストやお気に入りの管理を行えるほか、管理者はサーバータスクを実行できます。すべての呼び出しはアクセストークンを所有する Jellyfin ユーザーとして実行され、そのユーザーの権限とトークンに付与されたスコープに制限されます。このプラグインには、Jellyfin 以外の実行時依存関係はありません。

互換性

• Jellyfin 12.x のみ（12.4.0 に対してコンパイルされており、targetAbi は 12.4.0.0 です）。それより古いサーバーはサポートされていません。
• .NET 10 でビルドされています。
• MCP トランスポート：ステートレスな Streamable HTTP、POST /mcp。プロトコルリビジョン 2025-11-25、2025-06-18、2025-03-26 に対応しています。ステートレスな 2026-07-28 リビジョンにはまだ対応していません（ロードマップを参照）。
• 静的な Authorization: Bearer ヘッダーを送信するクライアントに対応しています。サポート対象のクライアントは Claude Code です。mcp-remote 経由の Claude Desktop は動作する見込みですが、まだ検証されていません。claude.ai のウェブコネクターには OAuth が必要なため、まだサポートされていません。

3 ステップでインストール

1. Jellyfin で ダッシュボード > プラグイン > リポジトリ > + に移動し、https://raw.githubusercontent.com/AeLui/jellyfin-plugin-mcp/main/manifest.json を追加します。
2. カタログを開いて MCP Server をインストールし、Jellyfin を再起動します。
3. ダッシュボード > プラグイン > MCP Server を開き、トークンを作成（ユーザーとスコープを選択）してコピーします。トークンは一度だけ表示されます。

手動インストールを含む詳しい説明は、docs/installation.md を参照してください。

クライアントを接続

https://jellyfin.example.com をサーバーアドレスに、jmcp_... をトークンに置き換えてください。

Claude Code（このリポジトリのマーケットプレイスにあるプラグインを使用。サーバーに接続し、エージェントスキルを追加します。URL とトークンの入力を求められ、トークンはシステムの認証情報ストアに保存されます）：

/plugin marketplace add AeLui/jellyfin-plugin-mcp
/plugin install jellyfin-mcp@jellyfin-plugin-mcp

Claude Code 2.1.275 以降では、次の 1 ステップだけで完了します：/plugin install jellyfin-mcp --marketplace AeLui/jellyfin-plugin-mcp。後から URL またはトークンを変更するには、/plugin configure jellyfin-mcp@jellyfin-plugin-mcp を実行します。

Claude Code（サーバーのみ）：

claude mcp add --transport http jellyfin https://jellyfin.example.com/mcp \
  --header "Authorization: Bearer jmcp_..."

Claude Desktop（claude_desktop_config.json。npx mcp-remote を実行するため、Node.js が必要です）：

{
  "mcpServers": {
    "jellyfin": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://jellyfin.example.com/mcp",
               "--header", "Authorization: Bearer jmcp_..."]
    }
  }
}

プラグインページのトークンダイアログで、両方の設定例を生成できます。Claude Desktop の手順は動作する見込みですが、稼働中のサーバーではまだ検証されていません。

スコープとツール

4 つのスコープに 22 個のツールがあります。トークンからは、許可されたスコープのツールのみを利用できます。

スコープ	ツール	用途
library	9	読み取り専用：検索、閲覧、詳細、人物、最近の項目、次に見る作品、視聴の続き、履歴
playback	4	セッション一覧、再生、再生操作、メッセージ表示
manage	4	ユーザー自身の視聴状態とお気に入り、およびユーザーが所有または編集できるプレイリスト
admin	5	ユーザー、スケジュール済みタスク、ライブラリスキャン、メタデータ更新（管理者のみ）

完全なリファレンス：docs/tools.md。

エージェントスキル

skills/jellyfin-mcp/SKILL.md は任意の Agent Skill で、これらのツールを使うタイミングと方法（操作前に ID を取得する、再生セッションを選ぶ、ページ分割する、破壊的な操作の前に確認するなど）をアシスタントに教えます。

上記の Claude Code プラグインには、このスキルが含まれています。他のエージェントでは、skills/jellyfin-mcp フォルダーをスキルディレクトリにコピーしてください（プラグインを使わない Claude Code の場合は、~/.claude/skills/ またはプロジェクト内の .claude/skills/）。プラグインをインストールする場合は、claude mcp add で追加したサーバーを削除してください。削除しないと、ツールが 2 回表示されます。

プライバシー

プラグインは Jellyfin サーバー内で動作し、外部への接続は行いません。Claude Code プラグインは、設定した Jellyfin の URL にのみ接続します。ツールの結果をアシスタントがどのように扱うかは、アシスタント独自のプライバシーポリシーに準拠します。

ドキュメント

• インストールとクライアントの設定
• ツールのリファレンス
• セキュリティモデル - LAN 外にエンドポイントを公開する前にお読みください
• アーキテクチャ
• 開発
• ロードマップ

プロジェクトを支援する

このプラグインは無料のオープンソースです。役に立った場合は、GitHub Sponsors を通じて開発を支援できます。

ライセンス

GPL-3.0。LICENSE を参照してください。