Jellyfin MCP Server

Name: Jellyfin MCP Server
Author: AeLui

作者：AeLui版本 0.6.0i★ –i在云端运行

注册名称io.github.AeLui/jellyfin-plugin-mcp

安装

概览

作者提供的说明（英文原文）

Jellyfin plugin: search, play and manage your media library from AI assistants, per-user tokens.

PopNx MCP 的三大支柱

这三项永远不会合并成一个分数：意见、测量和人气是不同的东西。

用户评价i暂无评价评价功能将在后续阶段与账户功能一起开放
我们的基础检查i1 项中通过 1 项依据公开信息检查；尚未扫描代码
使用情况i非常新★ –

它能帮你做什么

我们还没有为它写通俗的介绍。下面是我们从注册中心读取到的事实。

连接方式: 在云端运行
传输方式: Streamable HTTP
分类: 搜索与 AI 记忆
你需要填写：Authorization

安装

选择你使用的 AI 应用，然后复制设置。

安装之前

基础检查：1 项中通过 1 项
在作者的服务器上运行：你向它提出的内容会经过他们的服务器。
需要你自己填写： Authorization

标为机密的值是你账户的钥匙。千万不要分享给别人，也不要粘贴到聊天里。

你需要

在云端运行无需安装任何东西，通过互联网连接

你用的是哪个应用？

ClaudeClaude CodeCursorVS CodeChatGPT

在上方选择你的应用。我们会记住它，下次按钮会显示“安装到 …”。

这个地址需要在请求的 header 中放入密钥，而添加连接器的菜单无法设置。请改用 Claude Code、Cursor 或 VS Code。

在终端中运行这条命令

claude mcp add --transport http jellyfin-plugin 'https://{jellyfin_host}/mcp' --header 'Authorization: your-value'

运行前请先填写空着的值。

地址中有只有你知道的 {…} 部分（例如你的账户），请复制后自行填写。

或者自己复制设置

粘贴到项目中的 .cursor/mcp.json，或 ~/.cursor/mcp.json

{
  "mcpServers": {
    "jellyfin-plugin": {
      "url": "https://{jellyfin_host}/mcp",
      "headers": {
        "Authorization": "your-value"
      }
    }
  }
}

浏览器会先询问是否打开应用，然后应用会显示设置并请你确认。密钥的值会留空，由你自己填写。

地址中有只有你知道的 {…} 部分（例如你的账户），请复制后自行填写。

或者自己复制设置

粘贴到项目中的 .vscode/mcp.json

{
  "servers": {
    "jellyfin-plugin": {
      "type": "http",
      "url": "https://{jellyfin_host}/mcp",
      "headers": {
        "Authorization": "your-value"
      }
    }
  }
}

浏览器会先询问是否打开应用，然后应用会显示设置并请你确认。密钥的值会留空，由你自己填写。

这个地址需要在请求的 header 中放入密钥，而添加连接器的菜单无法设置。请改用 Claude Code、Cursor 或 VS Code。

你的选择通过 Cookie 保存在这台设备上，无需账户。

需要你填写的值

Authorization 机密必填 HTTP header
"Bearer " with a token created in Jellyfin Dashboard > Plugins > MCP Server

这些设置是根据作者在注册中心的条目生成的。如果 README 的写法不同，请以 README 为准。

它能做什么

这个地址需要填入你自己的值，所以我们无法替你读取工具列表。

基础检查i

我们检查的是任何人都能看到的信息；我们没有阅读代码。不适用的检查项不计入总数。 · 检查于 2026年11月8日

✓ 通过
作者与仓库一致
注册名称已通过 GitHub 账户 AeLui 验证，该账户拥有此仓库
… 尚未检查
仍在维护
我们还没有从 GitHub 读取这个仓库
… 尚未检查
有许可证
我们还没有从 GitHub 读取这个仓库
– 不适用
端点有响应
这个地址需要填入你自己的账户信息，所以我们无法替你检查
– 不适用
使用 OAuth 登录
这个地址需要填入你自己的账户信息，所以我们无法替你检查
… 尚未检查
工具描述中没有隐藏指令
尚未检查；我们会在检查端点时读取工具列表

与“搜索与 AI 记忆”中的其他服务器比较i

星标数多于此分类中其他 5684 个服务器的 0%
发布到注册中心的时间比此分类中其他 5684 个服务器的 99% 更新
基础检查结果等于或优于此分类中其他 5684 个服务器的 100%

与注册中心里这个分类中所有活跃的服务器比较。只有当发布者拥有该仓库时，星标数才计入。

常见问题

Jellyfin MCP Server 安全吗？

它在 1 项适用的基础检查中通过了 1 项。我们没有阅读代码。在添加密钥或令牌之前，请先看看这个服务器要求哪些权限，并使用只具备所需权限的密钥。

它需要哪些密钥或代码？

你需要填写：Authorization

它在我的电脑上运行还是在云端？

它在作者的云端运行。通过互联网连接，无需安装，但你发送的内容会经过作者的服务器。

它还在维护吗？

GitHub 仓库最后更新于–，最新版本（0.6.0）于今天进入注册中心。

哪些应用可以使用它？

支持 MCP 的应用，例如 Claude Desktop、Claude Code、Cursor 和 VS Code。它通过 URL 连接，所以接受远程 MCP 服务器的应用也可以使用，例如开启开发者模式的 ChatGPT。

有什么可以替代它？

同一分类中有：Context7, Codebase Memory, Exa

替代选择

同一分类中其他作者的服务器，按星标数排序。

如何看卡片：↓ 每周下载量i★ GitHub 星标i三大支柱：评价 · 检查 · 使用情况i更新 = 最新版本发布到注册中心的时间i

Context7

Up-to-date docs for AI agents

作者：upstash广泛使用↓ 97.3万/周★ 6.4万前天更新

电脑或云端

安装

Codebase Memory

Codebase knowledge graph for AI agents — 162 languages, sub-ms queries, 99% fewer tokens.

作者：DeusData广泛使用↓ 1.8万/周★ 4.8万22天前更新

在你的电脑上运行

安装

Exa

Connect AI agents to Exa for web search, content fetching, and multi-step research.

作者：exa-labs正在增长★ 52132个月前更新

在云端运行✓ exa.ai

安装

作者的 README

打开 README

按原文从作者的仓库复制。PopNx MCP 没有审查或背书其内容。HTML、图片和脚本已被移除。链接会离开本站。

Jellyfin MCP Server plugin

A Jellyfin plugin that exposes your server to AI assistants through the Model Context Protocol (MCP). Assistants such as Claude can search and browse your library, see what you are watching, control playback on your devices, manage playlists and favorites, and (for administrators) run server tasks. Every call runs as the Jellyfin user who owns the access token, limited to that user's permissions and to the scopes granted to the token. The plugin has no runtime dependencies besides Jellyfin itself.

Compatibility

Jellyfin 12.x only (compiled against 12.4.0, targetAbi 12.4.0.0). Older servers are not supported.
Built with .NET 10.
MCP transport: Streamable HTTP, stateless, POST /mcp. Protocol revisions 2026-07-28 (stateless, with server/discover) and 2025-11-25, 2025-06-18 and 2025-03-26 (with initialize). Tools return structuredContent described by an outputSchema.
Clients that send a static Authorization: Bearer header work; Claude Code is the supported client. Claude Desktop through mcp-remote is expected to work but is not yet verified. claude.ai web connectors need OAuth, which this plugin does not offer.

Install in three steps

In Jellyfin go to Dashboard > Plugins > Repositories > + and add https://raw.githubusercontent.com/AeLui/jellyfin-plugin-mcp/main/manifest.json.
Open the Catalog, install MCP Server and restart Jellyfin.
Open Dashboard > Plugins > MCP Server, create a token (pick the user and the scopes) and copy it. It is shown only once.

More detail, including a manual install, is in docs/installation.md.

Connect a client

Replace https://jellyfin.example.com with your server address and jmcp_... with your token.

Claude Code, with the plugin from this repository's marketplace (connects the server and adds the agent skill; it asks for the URL and the token, and keeps the token in your system's credential store):

/plugin marketplace add AeLui/jellyfin-plugin-mcp

/plugin install jellyfin-mcp@jellyfin-plugin-mcp

On Claude Code 2.1.275 or later, one step is enough: /plugin install jellyfin-mcp --marketplace AeLui/jellyfin-plugin-mcp. To change the URL or token later, run /plugin configure jellyfin-mcp@jellyfin-plugin-mcp.

Claude Code, server only:

claude mcp add --transport http jellyfin https://jellyfin.example.com/mcp \

--header "Authorization: Bearer jmcp_..."

Claude Desktop (claude_desktop_config.json; requires Node.js because it runs npx mcp-remote):

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

The token dialog in the plugin page generates both snippets for you. The Claude Desktop flow is expected to work but has not been verified against a live server yet.

Scopes and tools

25 tools in four scopes. A token only sees the tools its scopes allow.

Scope	Tools	Purpose
`library`	12	Read-only: search, browse, details, people, recent, next up, continue watching, history, similar items, movie recommendations, collections
`playback`	4	List sessions, play, control playback, show a message
`manage`	4	The user's own watch state and favorites, plus playlists the user owns or may edit
`admin`	5	Users, scheduled tasks, library scan, metadata refresh (administrators only)

Full reference: docs/tools.md.

Agent skill

skills/jellyfin-mcp/SKILL.md is an optional Agent Skill that teaches an assistant when and how to use these tools: getting ids before acting, picking a playback session, paging, and asking before destructive actions.

The Claude Code plugin above includes it. Other agents: copy the skills/jellyfin-mcp folder into their skills directory (for Claude Code without the plugin, ~/.claude/skills/ or .claude/skills/ in a project). If you install the plugin, remove any server you added with claude mcp add, or the tools show up twice.

Privacy

The plugin runs inside your Jellyfin server and makes no outbound connections. The Claude Code plugin connects only to the Jellyfin URL you configure. What your assistant does with the tool results is governed by the assistant's own privacy policy.

Documentation

Installation and client setup
Tool reference
Security model - read this before exposing the endpoint beyond your LAN
Architecture
Development
Roadmap

Support the project

The plugin is free and open source. If it is useful to you, you can support its development through GitHub Sponsors.

License

GPL-3.0, see LICENSE.