MCPcopy Index your code
hub / github.com/ShotHeadman/mdcz

github.com/ShotHeadman/mdcz @v0.10.0

Chat with this repo
repository ↗ · DeepWiki ↗ · release v0.10.0 ↗ · + Follow
5,029 symbols 13,408 edges 801 files 13 documented · 0%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

MDCz

Electron React TypeScript pnpm

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

配合 Emby、Jellyfin 等本地媒体库管理软件,通过识别影片识别码(番号)自动抓取元数据、封面、缩略图等信息,供本地影片分类整理使用。

功能

  • 多站点元数据刮削(DMM、FC2 等)
  • Emby 演员信息同步
  • NFO 文件生成
  • 批量处理
  • 影片文件自动归类整理

快速开始

下载使用

WebUI / 自托管用户推荐使用 Docker:

docker run -d \
  --name mdcz \
  -p 3838:3838 \
  -v mdcz-data:/data \
  --restart unless-stopped \
  ghcr.io/shotheadman/mdcz:latest

打开 http://localhost:3838。如需不用 Docker,可下载 mdcz-<version>.tar.gz,安装 Node.js 24 或更新版本。解压后运行安装脚本;

tar -xzf mdcz-<version>.tar.gz
cd mdcz-<version>
./install.sh
./start.sh

Windows 使用:

.\install.ps1
.\start.bat

本地开发

pnpm install
pnpm dev:webui

构建

pnpm build:win     # Windows
pnpm build:mac     # macOS (DMG)
pnpm build:linux   # Linux (AppImage)

注意事项

[!WARNING] 本项目仍处于活跃迭代阶段。当前刮削核心功能已就绪,部分高级设置项仍在测试完善中。如遇异常,欢迎提交 Issue 进行反馈。

[!IMPORTANT] 网络环境提示:不同数据源存在地域访问限制。例如 DMM 仅支持日本 IP,而部分站点可能会屏蔽特定地区的代理。请根据目标数据源,配置合适的代理节点及分流规则。

上游项目

MDCx,感谢原作者的卓越贡献。

授权许可

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

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

预览截图

overview workbench tools settings

友情链接

LINUXDO

Extension points exported contracts — how you extend this code

RuntimePhotoActorSourceProvider (Interface)
(no doc) [13 implementers]
packages/runtime/src/mediaserver/photoSync.ts
BaseActorSource (Interface)
(no doc) [18 implementers]
apps/desktop/src/main/services/actorSource/types.ts
PersistenceDatabase (Interface)
(no doc) [3 implementers]
packages/persistence/src/database.ts
StorageEntry (Interface)
(no doc)
packages/media-store/src/filesystem.ts
LogsListViewProps (Interface)
(no doc)
packages/views/src/logs/LogsListView.tsx
MovieAssetFileNames (Interface)
(no doc)
packages/shared/assetNaming.ts
ShortcutInputProps (Interface)
(no doc)
packages/ui/src/ShortcutInput.tsx
TestServerOptions (Interface)
(no doc)
apps/server/src/app.test.ts

Core symbols most depended-on inside this repo

get
called by 275
packages/runtime/src/scrape/mountedRootScrapeRuntime.ts
resolve
called by 165
packages/views/src/common/ImageOptionCard.tsx
parse
called by 161
apps/desktop/src/main/services/UpdateService.ts
cn
called by 159
packages/ui/src/utils.ts
toErrorMessage
called by 130
packages/shared/error.ts
getState
called by 118
packages/runtime/src/tasks/session/ScrapeSession.ts
getState
called by 117
apps/server/src/services/persistenceService.ts
action
called by 80
packages/shared/ipcTypes.ts

Shape

Function 2,603
Method 1,317
Interface 701
Class 400
Enum 8

Languages

TypeScript100%

Modules by API surface

packages/runtime/src/config/index.ts71 symbols
packages/runtime/src/network/NetworkClient.ts62 symbols
packages/runtime/src/scrape/aggregation.ts56 symbols
packages/runtime/src/scrape/mountedRootScrapeRuntime.ts46 symbols
packages/runtime/src/crawler/sites/avbase.ts42 symbols
packages/persistence/src/libraryRepository.ts40 symbols
apps/server/src/services/scrapeService.ts37 symbols
packages/runtime/src/crawler/sites/r18.ts35 symbols
packages/runtime/src/crawler/sites/avwikidb.ts35 symbols
packages/runtime/src/mediaserver/jellyfin.ts34 symbols
packages/views/src/maintenance/ChangeDiffView.tsx33 symbols
packages/runtime/src/network/index.ts33 symbols

For agents

$ claude mcp add mdcz \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page