# asset-mcp — 创作者素材库 MCP Server
## 演示

![功能总览](assets/demo_features.png)

![血缘与语义搜索演示](assets/demo_usage.gif)

> 本地素材管理：扫描入库 + 智能批量重命名 + 标签检索 + 血缘追踪。
> 与内容生产 MCP（TTS/视频/音频/图片/文案）产出自动入库，形成**生产→入库→复用**闭环。

## 为什么做这个

- 调研确认：**"中文创作者本地素材库" MCP = 真空白**（仅有115网盘/Immich等垂直场景）
- 创作者素材一多就乱（视频/音频/图片/字幕/文案散落各处），是真实痛点
- 你已做的 6 个内容生产 MCP 每次产出中间件+成品，**正是"素材一多就乱"的来源**——素材库把系列闭环

## 核心能力

| 工具 | 说明 |
|---|---|
| `scan_folder_tool` ⭐ | 扫描文件夹，素材（视频/音频/图片/字幕/文案）登记入库 |
| `rename_batch_tool` ⭐ | 智能批量重命名（{date}/{seq}/{name}/{ext} 模板） |
| `add_tags_tool` | 打标签 |
| `search_assets_tool` ⭐ | 按标签/文件名/类型/项目检索 |
| `track_lineage_tool` | 记录素材血缘（子素材←父素材） |
| `get_lineage_tool` ⭐ | 查询血缘：素材源自什么、被哪些成品用到了 |
| `register_asset_tool` | 单个素材自动入库（供其他 MCP 调用） |
| `semantic_search_tool` ⭐⭐ | **语义检索**：输入描述找相关素材（BGE向量，"这段BGM用在哪"） |
| `build_vector_index_tool` | 建立/重建语义索引 |

## 生态协同（生产→入库→复用）

```
tts-mcp-server      音频 → register_asset → 素材库
video-workflow      视频 → register_asset → 素材库
audio-post          成品 → register_asset → 素材库
poetry/script       文案 → register_asset → 素材库
asset-mcp           入库 → 检索 → 血缘 → 复用
```

## 示范

```
scan_folder(folder="我的项目", project="纪录片")
→ 扫描全部素材入库

rename_batch(pattern="旅行_{date}_{seq:03d}{ext}")
→ IMG_001.jpg → 旅行_20260101_001.jpg

link_lineage("配音.mp3", "文案.txt")
→ get_lineage("配音.mp3") → 源自"文案.txt"
```

## 安装

```bash
pip install asset-mcp-server
```

## 使用

```json
{
  "mcpServers": {
    "asset": {
      "command": "asset-mcp",
      "args": []
    }
  }
}
```

## Roadmap

- [x] P0: 扫描/重命名/标签/检索/血缘/自动入库
- [x] P1: 向量语义检索（BGE-small-zh，"这段素材用在哪"）
- [ ] P2: 素材去重/重复检测、缓存缩略图

## License

MIT。

---

## 系列（Chinese MCP Suite）

> 中文内容创作/工具 MCP 全家桶，全本地、CPU、离线：


- [tts-mcp-server](https://github.com/Gollum-code/tts-mcp-server) — TTS聚合+字幕对齐
- [idphoto-mcp](https://github.com/Gollum-code/idphoto-mcp) — 本地证件照
- [audio-post-mcp](https://github.com/Gollum-code/audio-post-mcp) — 音频后期
- [video-workflow-mcp](https://github.com/Gollum-code/video-workflow-mcp) — 视频工作流
- [poetry-mcp](https://github.com/Gollum-code/poetry-mcp) — 古诗文
- [script-mcp](https://github.com/Gollum-code/script-mcp) — 口播文案
- **asset-mcp**（本仓库）— 素材库
- [idiom-mcp](https://github.com/Gollum-code/idiom-mcp) — 成语典故
- [weather-mcp](https://github.com/Gollum-code/weather-mcp) — 天气/空气