杰利芬mcp
用于Jellyfin媒体库管理的MCP（模型上下文协议）服务器。 让您要求GitHub Copilot分析重复项、修复CD分割、查找未识别的文件， 并通过自然语言重新组织你的库。
工具
| 工具 | 说明 |
|---|---|
get_stats | 快速健康概述：总计数、缺失元数据、重复组 |
find_missing_metadata | 查找缺少TMDB和/或IMDB标识符的电影/系列 |
analyze_duplicates | 按TMDB ID分组，按版本对质量进行分类（2160p/1080/SD，Bluray/WEB/DVD） |
find_cd_splits | 在Jellyfin中查找未正确堆叠的CD分割文件 |
generate_move_plan | 为多版本整合生成重命名/移动计划 |
execute_move | 移动或重命名文件（Linux路径→ Windows UNC自动转换）。使用 dry_run: true 首先 |
refresh_library | 触发完整的水母库重新扫描 |
analyze_tv_structure | 电视库的全面结构审计：重复的系列条目、发行包文件夹名称、每集子目录中的剧集、错误的季号 |
设置
1.安装和构建
npm install
npm run build2.配置环境
复制 .env.example 到 .env 并填写您的值：
JELLYFIN_URL=http://your-jellyfin-server:8096
JELLYFIN_TOKEN=your_api_token
MOUNT_1_LINUX=/mnt/usb1
MOUNT_1_WINDOWS=\\your-nas\share查找您的API代币：Jellyfin→ 仪表盘→ API密钥。
3.连接到VS代码副本
这 .vscode/mcp.json 文件已为此工作区配置。 打开VS Code，在代理模式下启动Copilot聊天，然后 jellyfin MCP服务器将可用。
典型工作流程
1. get_stats → overview of library health
2. find_missing_metadata → find files without TMDB/IMDB
3. analyze_duplicates sort_by=count → movies with the most duplicate versions
4. generate_move_plan tmdb_id= → preview renames for one movie
5. execute_move dry_run=true → verify a single operation
6. execute_move dry_run=false → execute
7. refresh_library → Jellyfin picks up the changes电视剧审计
1. analyze_tv_structure → full structural report:
- duplicate series entries
- series folders with release-pack names
- episodes in per-episode subdirectories
- wrong season numbers (year/release parsed as season)
2. execute_move dry_run=true → verify a move before executing
3. execute_move dry_run=false → move the file/folder
4. refresh_library → Jellyfin picks up the changes路径映射
Jellyfin在Linux上运行，并报告以下路径 /mnt/usb1/Filmer/.... 服务器会自动将这些路径转换为Windows UNC路径以进行文件操作 使用 MOUNT_* 环境变量。每个挂载点添加一对：
MOUNT_1_LINUX=/mnt/usb1
MOUNT_1_WINDOWS=\\nas\share1
MOUNT_2_LINUX=/mnt/video
MOUNT_2_WINDOWS=\\nas\video项目结构
src/
index.ts MCP server — tool definitions and handlers
jellyfin.ts Jellyfin REST API client
paths.ts Linux ↔ Windows UNC path conversion
quality.ts Video quality classification from filename
dist/ Compiled JavaScript
docs/
JELLYFIN-MEDIA-GUIDE.md Media organisation best practice guide
tv-serie-rapport.md TV series structural audit report
.vscode/
mcp.json VS Code Copilot MCP server configuration
.env.example Environment variable template文档
看 docs/JELLYFIN-MEDIA-GUIDE.md 为了完整 媒体组织最佳实践指南，涵盖：
- 电影、电视剧和动漫的文件夹结构
- 多版本电影和CD分割命名
- NFO元数据文件和艺术品惯例
- 字幕命名和外部曲目
- 附加内容、预告片和特辑
- 电视特辑（第0季）和动漫命名
- 库扫描、性能和插件建议
发展
npm run dev # Run with tsx (no build step)
npm run build # Compile to dist/