Jellyfin MCP Server (Alpha Git)

Jellyfin MCP服务器

能力

图书馆管理

• 列出库 --枚举所有已配置的库（电影、音乐、节目、书籍等）
• 扫描库 --触发完全重新扫描或重新扫描特定库

搜索和浏览

• 搜索媒体 --按关键字查找项目，可选类型过滤（音频、音乐专辑、音乐艺术家、电影、系列、剧集、书籍）
• 浏览库 --分页浏览，可配置排序（按名称、添加日期、评级、年份等）
• 获取商品详细信息 --任何项目的完整元数据，包括流派、标签、人物、文件路径、比特率和提供商ID
• 获取最近的项目 --最近添加的内容，按最新内容排序
• 查找类似项目 --基于给定项目发现相关内容

播放列表管理

• 列出、创建和删除播放列表
• 修改播放列表 --在单个操作中添加和删除项目
• 检查播放列表内容 --包括删除所需的播放列表项目ID

计划任务

• 列出计划任务 --查看所有任务的当前状态和进度百分比
• 按需运行任务 --立即触发任何预定任务（库扫描、歌词下载等）

服务器监控

• 服务器状态 --版本信息、活动会话（正在播放）、计划任务状态和最近的活动日志——所有这些都在一个可配置的调用中

需求

• Python 3.10+
• 紫外线 （推荐）或pip
• 带有API密钥的Jellyfin服务器

安装

git clone https://github.com/AlphaGit/jellyfin-mcp-server.git
cd jellyfin-mcp-server
uv sync

配置

1. 在下的Jellyfin仪表板中生成一个API键 管理>高级>API密钥

1. 复制示例env文件并填写您的值：

cp .env.example .env

JELLYFIN_URL=https://your-jellyfin-server.com
JELLYFIN_API_KEY=your-api-key-here
JELLYFIN_USERNAME=your-username-here

用户名在启动时解析为用户ID。这对于用户范围的API调用（播放列表、项目详细信息等）是必需的，因为API密钥验证不支持 /Users/Me 终点。

使用Claude代码

存储库包括 .mcp.json 自动注册服务器。只需在项目目录中打开Claude Code并重新启动——工具将立即可用。

若要从其他项目使用此服务器，请将其添加到该项目的 .mcp.json:

{
  "mcpServers": {
    "jellyfin": {
      "type": "stdio",
      "command": "uv",
      "args": ["run", "--project", "/path/to/jellyfin-mcp-server", "python", "jellyfin_mcp.py"]
    }
  }
}

与其他MCP客户端一起使用

直接运行服务器：

uv run python jellyfin_mcp.py

服务器使用MCP协议通过stdio进行通信。

许可证

麻省理工学院