AI导哈

Jellyfin媒体服务器管理工具

一个通过MCP协议让AI助手管理Jellyfin媒体服务器的工具，支持库管理、搜索浏览、播放列表管理和服务器监控。

  • by AlphaGit
  • Python
  • 本地部署
  • 9 星标
  • 更新于
在 GitHub 查看 AlphaGit/jellyfin-mcp-server

使用说明

Jellyfin MCP服务器

一 主控程序 让AI助手管理 水母 媒体服务器。建于 FastMCP 设计用于 克劳德代码，但与任何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密钥

  2. 复制示例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进行通信。

许可证

麻省理工学院

相关 MCP