mdcz

中文 | English

MDCz

高效、现代的影片元数据刮削与媒体库管理工具

---

MDCz 是什么？

MDCz 是一款现代化的本地影片元数据刮削与整理工具。

配合 Emby、Jellyfin 等媒体库管理软件，通过智能识别影片番号或文件名，自动抓取多站点的元数据、高清封面、剧照及演职员信息，生成标准化 NFO 文件，并自动规范化重命名与归类本地影片。

---

核心功能

• 多站点聚合刮削 — 支持 DMM、FC2、AVBase、AVWikiDB、JavBus、JavDB、MGStage、Prestige 等主流数据源
• 双端支持 — 提供开箱即用的跨平台桌面客户端与轻量 WebUI / Docker 自托管方案
• 演员别名归一 — 支持自定义演员名称映射，将不同来源的别名自动合并为标准规范名
• Emby / Jellyfin 深度集成 — 自动同步人物头像、生成规范 NFO 文件及多级剧照
• 多媒体格式兼容 — 完善支持分段影片（CD1/CD2/Part）、STRM 流媒体文件及外挂字幕文件关联移动
• 批量工作台 — 具备可视化批量任务队列与执行前变更对比（Diff Preview）
• 实用工具箱 — 提供重名查重、规则重命名及媒体库数据维护能力

---

下载与安装

桌面客户端

前往 Releases 下载对应文件：

文件	适用于	自动更新	数据目录
MDCz-<版本>-win-x64-setup.exe	Windows 10 及以上，推荐	应用内下载，重启后安装	%APPDATA%\mdcz
MDCz-<版本>-win-x64-portable.zip	Windows 便携版，解压即用	提示新版本，需手动下载替换	程序目录下的 data\
MDCz-<版本>-mac-arm64.dmg	macOS Apple Silicon（不提供 Intel 版）	提示新版本，需手动下载替换	~/Library/Application Support/mdcz
MDCz-<版本>-linux-x86_64.AppImage	Linux x64	应用内下载，重启后安装	~/.config/mdcz

便携版的配置、数据库和日志都在 data\ 里，升级时保留这个文件夹，替换其余文件即可。

Docker 部署（推荐 NAS / 服务器）

推荐使用仓库提供的 compose.yaml 进行部署，详细步骤请参考 Docker 部署与维护指南。

• 快速上手：将配置模板复制为 .env，填写真实版本号与媒体路径后，执行 docker compose up -d 即可启动。
• 首次访问：浏览器打开 http://<服务器IP>:3838（默认绑定 127.0.0.1，NAS 局域网访问请在 .env 中调整绑定 IP）。系统无默认密码，首次访问直接按提示设置管理员密码，随后即可在设置中添加媒体库。

WebUI 压缩包（不使用 Docker）

Releases 中的 mdcz-<版本>.tar.gz 可直接在装有 Node.js >= 24 的机器上运行，安装和启动方式见包内 README。

源码运行

环境准备与开发命令见 CONTRIBUTING.md。

---

界面预览

刮削结果	剧照和预告片

---

注意事项

---

上游与致谢

• 上游项目：MDCx，感谢原作者的卓越贡献。

---

授权许可

本项目采用 GPLv3 开源协议。使用本项目即代表同意以下条款：

• 本项目仅供技术研究与个人交流使用。
• 请勿在公共社交平台大范围传播或商业化。
• 使用过程中请严格遵守当地法律法规，用户自行承担法律责任及后果。

---

问题反馈 · LINUXDO 社区