MCP：把业务串成一套服务

不知道从哪看？先回从这里开始。这页只展开 Agent 怎么接、哪些段已经通。

museav-cli 和 museav-mcp 设想不同：

CLI 是单一能力。museav 只做出图 / 读图 / 模板，不负责把别的工具捏在一起。
MCP 是集成层。Agent 装一次，按任务路由到对应的开源 CLI 或外部平台。

周边工具各自开源、各自能单独跑。MCP 要做的是把同一条业务里用到的几段接上，而不是再列一张仓库目录。

2026-10-02 起：MCP 按「能力分组」组织

museav-mcp 2.2.0 起不再只包 museav 一家 —— 它是这套工具链的集成层本身：一个分组 = 一个开源项目及其 CLI，装了哪个 CLI 就自动长出哪组工具。现在有 6 组：museav（出图/后期/素材）、vlm（本地看图）、 contrast（对比度门禁）、 facet（Markdown 排版）、 reel（竖版短视频合成）、 browser（浏览器操控）。

没装 CLI 的分组不会注册（工具 schema 每次请求都要发出去，不该为没装的东西付 token），但也不会消失：调一次 groups_list 就能看到全部能力和各自的安装命令。

业务怎么串

下面每条都是真实会走的活。标了「MCP」的已经能从 Agent 里调；标了「CLI / 计划」的还要自己在终端跑，或等 MCP 接下一段。

1. 出一张能发的图

museav gen 出图 → 需要的话 remove-bg / upscale / compress → 作品进素材库。

这一段 MCP 已通（list_templates / list_skills 挑模板和技能 → gen_background 出图 → remove_bg / upscale_image / remove_watermark / compress_image 后期 → upload_asset 拿直链）。

2. 竖版短视频（素材 → 成片）

museav gen --video 给你的是无声、无字幕的片子，不是成品。

出图 / 出无声片（museav）  →  抠图（museav remove-bg）
        ↓
配音 / 配乐（voxflow，计划接入 MCP）
        ↓
套版式出片（reel-kit，计划接入 MCP）

分界：reel-kit 的 README 和 museav 写的是同一句话——museav 出原料，reel make 出能发的竖版。

3. 小红书卖课 / 上架 Skill

写教程 Markdown
    → facet 出 PDF + 分享长图（MCP：facet_build，模板先用 facet_templates 查）
    → museav 出样图（MCP：gen_background）、列模板（MCP：list_templates）
    → 你自己挑要上架的模板（不写死）
    → SkillHub 上传（MCP：skillhub_publish，默认 dry-run）
    → 领取码发货仍走管理后台「小红书发货」，和 SkillHub 不是一条线

模板必须从 list_templates（CLI 里是 museav templates）里你自己选。只有你说「提交 / 确认 / submit」才真正上传。

4. 微信表情投稿

一张 IP 正面照 → museav 批量出图 → charmoji 切图、机检、交清单。

出图段 MCP 已通；切图投稿还是那条独立 CLI（计划接入）。

5. 密钥怎么给 Agent

kyvault 管各路 Key。Agent 只拿别名，看不到明文。这是横切能力，不是某条业务的一环。它不进公开 MCP：get 会打印明文，接进来等于把「Agent 看不到明文」这条设计拆掉；要接也只能接成不给读明文的形态。

现在 Agent 里有什么

43 个工具（museav-mcp >= 2.2.0），按 6 个能力分组 + 1 个发现工具：

分组	项目	工具数	装了才启用
`museav`	museav-cli	17	`npm i -g museav-cli`（>= 3.9.0）
`vlm`	mlx-vlm-kit	4	`pipx install git+…/mlx-vlm-kit.git`（Apple Silicon）
`contrast`	contrast-guard	3	`npm i -g contrast-guard`
`facet`	@webkubor/facet	2	`npm i -g @webkubor/facet`
`reel`	@kubor/reel-kit	3	`npm i -g @kubor/reel-kit`（+ ffmpeg）
`browser`	lite-browser	13	`curl -fsSL …/install.sh \| bash`
—	本 MCP 自带	1	`groups_list`，无依赖

工具数走过一轮弯路：1.3.0 随 CLI 3.6.0 移除 skillhub 掉到 18 个，2.1.0 跟着 CLI 3.9.0 把 skillhub 接回恢复到 21 个，2.2.0 分组化并新增 contrast / facet / reel / browser 四组到 43 个。 21 个老工具的名字一个没动 —— 它们是已发布版本的契约，有测试逐个钉着。

工具	背后	落在上面哪条业务
`gen_background`	`museav gen`	1、2、3、4 的出图
`remove_bg` / `upscale_image` / `remove_watermark` / `compress_image`	`museav` 本地后期	1、2
`list_templates` / `list_skills` / `list_video_templates`	`museav templates` / `museav skills` / `museav video-templates`	1、2、3 —— 挑模板与技能，别硬编码
`list_models`	`museav models [--video]`	1、2 —— 挑图片模型或视频档次（对外名），直接喂 `gen_background` 的 model
`balance`	`museav balance`	出图前自查余额
`list_jobs`	`museav jobs`	出图失败回查、回头找结果 URL
`upload_asset`	`museav upload`	1、2 —— 垫图要 URL 时用
`image_to_template`	`museav image-to-template`	3 —— 一张好图变可复用模板
`reverse`	`museav reverse`（中台 API）	1、3 —— SCULPT 六要素反推，喂回出图更顺手；*图像识别仍优先走下方的 `vlm_`**
`vlm_describe` / `vlm_ask` / `vlm_cover_check` / `vlm_reverse_prompt`	`vlm`（mlx-vlm-kit，本地 MLX，免登录零成本）	1、3 —— 看图、质检、反推 prompt 喂回出图
`skillhub_tags` / `skillhub_whoami` / `skillhub_publish`	`museav skillhub …`（需 CLI >= 3.9.0）	3
`contrast_check` / `contrast_init` / `contrast_measure`	`contrast-guard`	出图/网页交付前的对比度门禁：`check` 查色值对不对，`measure` 量实际字号灰阶（要浏览器）
`facet_templates` / `facet_build`	`facet`	3 —— 教程 Markdown 出 PDF 与分享长图
`reel_templates` / `reel_bgm` / `reel_make`	`reel`（需 ffmpeg）	2 —— 素材 + 逐句文案出竖版成片：museav 出原料，reel 出能发的成品
`browser_open` / `browser_snapshot` / `browser_click` / `browser_type` / `browser_press` / `browser_scroll` / `browser_screenshot` / `browser_eval`	`lite-browser`（真实 Chrome）	2、3、4 —— 没有官方 CLI 的服务只能这么接；`snapshot` 给 @编号，`eval` 用来读正文
`browser_status` / `browser_await_human` / `browser_resume`	`lite-browser` 的人类交接协议	撞到登录墙时：看状态 → 阻塞等人 → 恢复。退出码 3/4 是状态不是故障
`browser_sessions` / `browser_close`	`lite-browser`	排查「浏览器被谁占着」/ 用完关闭

skillhub_publish 默认 dry-run：不带 submit=true 只本地打包校验、不上传不提交，把待提交内容返回给你核对。提交不可逆——Skill ID 是平台主键、跨版本不可改名。真提交前它会先查登录态，未登录时直接报错而不是挂住：二维码要等 MCP 进程结束才能返回给你，硬等就是死锁，所以会让你去终端跑一次 museav skillhub login 扫码。

MCP 侧也受 CLI 的平台资产护栏约束：Skill 正文抄了 MUSE AV 平台公共模板的提示词会被拒，只引用模板 slug 则放行。详见命令文档。

还没接线、但业务上已经在用的：voxflow、reel-kit、charmoji。（facet 已在 2.2.0 接上；kyvault 不进公开 MCP —— 它是密钥库，get 会打印明文，这类能力放进来就是把「Agent 看不到明文」这条设计拆了，要接只能接成不给读明文的形态。）

设计约定：

媒体走文件绝对路径，不走 base64
本地后期与 vlm_* 不耗中台额度
某条能力已有 CLI，MCP 只 exec，不重写
清单类取 stderr 的那份：museav 的 templates / skills stdout 只有裸 id / slug，带中文名、分类、字段的可读表格走 stderr。取错了 Agent 拿到的就是一串 UUID，挑不了。 jobs 反过来，stdout 是完整 JSON
输出已存在时 CLI 会拒绝覆盖，MCP 保留这个语义：要覆盖得显式传 overwrite: true

前置与安装

装哪几个由你决定 —— 没装的分组就是不注册，不会报错。每组对应一条命令：

bash

npm i -g museav-cli        # museav 组：出图 / 后期 / 素材 / SkillHub
museav --version

bash

pipx install git+https://github.com/webkubor/mlx-vlm-kit.git   # vlm 组：本地看图
vlm --version

bash

npm i -g contrast-guard    # contrast 组：对比度门禁
npm i -g @kubor/reel-kit   # reel 组：竖版短视频合成（另外要 brew install ffmpeg）
curl -fsSL https://raw.githubusercontent.com/webkubor/lite-browser/main/install.sh | bash   # browser 组
npm i -g @webkubor/facet   # facet 组：Markdown 排版

vlm 需要 Mac + Apple Silicon，首次用会下模型（约 2.9GB）。

MCP 本体一行接上（2026-09-08 起发到 npm，不用再 clone 自己 build）：

bash

claude mcp add museav -- npx -y museav-mcp

手写配置也一样：

json

{
  "mcpServers": {
    "museav": {
      "command": "npx",
      "args": ["-y", "museav-mcp"]
    }
  }
}

想让没装 CLI 的分组也列出来（调用时才提示装什么），加一个环境变量：

json

{
  "mcpServers": {
    "museav": {
      "command": "npx",
      "args": ["-y", "museav-mcp"],
      "env": { "MUSEAV_MCP_GROUPS": "all" }
    }
  }
}

MUSEAV_MCP_GROUPS 还支持裁剪：facet,contrast 只开这两组，-museav 表示默认集里去掉 museav。

可执行文件不在全局 PATH 时设 MUSEAV_BIN / MLX_VLM_BIN / CONTRAST_GUARD_BIN / FACET_BIN。改 museav-mcp 这个仓库本身时才需要 pnpm install && pnpm build，把 command 换成 node、指向 dist/index.js。

装完重启 Agent，问一句「这个 MCP 有哪些能力分组」—— groups_list 会列出全部 4 组、各自几个工具、装什么命令、为什么某一组没启用。

出图的规矩

gen_background 的 prompt / skill / template 必须且只能给一个：

prompt —— 自己写提示词
skill —— 用技能库，配合 input 一句业务描述
template —— 用模板

给 Agent

优先用 skill：提示词在服务端展开，Agent 只描述画什么。

本地后期超时 10 分钟，大图会慢，不是卡死。

验证

改这个仓库时可以直接跑：

bash

cd museav-mcp && node test-mcp.mjs
# TOOLS_LIST_OK count = 43
# LEGACY_OK 21 个老工具全部还在

工具总数是个断言：加了工具忘了改 README / 文档里的数字，CI 会红。 LEGACY_OK 那行是另一条更硬的断言：分组化重构里老工具一个都不许掉 —— 它们是已发布版本的契约，老用户的 agent 正靠这些名字干活。

MCP：把业务串成一套服务 ​

业务怎么串 ​

1. 出一张能发的图 ​

2. 竖版短视频（素材 → 成片） ​

3. 小红书卖课 / 上架 Skill ​

4. 微信表情投稿 ​

5. 密钥怎么给 Agent ​

现在 Agent 里有什么 ​

前置与安装 ​

出图的规矩 ​

验证 ​

相关 ​

MCP：把业务串成一套服务

业务怎么串

1. 出一张能发的图

2. 竖版短视频（素材 → 成片）

3. 小红书卖课 / 上架 Skill

4. 微信表情投稿

5. 密钥怎么给 Agent

现在 Agent 里有什么

前置与安装

出图的规矩

验证

相关