@starreel/mcp 0.1.11 → 0.1.13

package/SKILL.md

@@ -38,9 +38,16 @@ create_drama → set_script(raw) → rewrite_script(AI draft, user may edit)
 standard extract → storyboards → … flow. Call `list_project_options` first to
 show the user the real project types, aspect ratios, and resolutions.
 
-Free steps: `create_drama`, `set_script`, all `get_*`, edits, `compose_episode`.
-Metered text (post-paid): `rewrite_script`, `extract_assets`. Every image/video
-step is split into `quote_*` + `generate_*`.
+Free (DB + ffmpeg, no vendor call): `create_drama`, `set_script`, all `get_*`,
+edits, `update_project_settings`, `compose_episode`, `render_multi_aspect`,
+`generate_sfx` / `generate_effects` / `generate_transitions` (local-library
+match), `generate_deliverables`, `add_product` / `list_products`.
+Metered (every AI generation): all images, all video, TTS, and all LLM text
+(`rewrite_script`, `extract_assets`, art-bible, visual-lock, setting-brief,
+style/color/motion locks, MV story/script, subtitle translation). Only the
+big-ticket image/video stages (portraits, storyboards, frames, videos,
+scene-images) carry a `quote_*`; the other metered steps have no quote and bill
+by usage — 402 mid-run if the balance can't cover them (never overdraft).
 
 ## The ten disciplines (hard rules)
 
@@ -53,10 +60,12 @@ content that will be rejected.
    and tell the user to recharge. Never loop-retry a 402 — it will never
    succeed and only spins.
 
-2. **Quote before you spend; the quote is the charge.** Every spending step is
-   `quote_*` then `generate_*`. Show the user the quoted cost and get an
-   explicit yes before calling `generate_*`. For video, quote == actual charge.
-   Do not auto-approve large spends on the user's behalf.
+2. **Quote before you spend; the quote is the charge.** Big-ticket stages
+   (portraits, storyboards, frames, videos, scene-images) are `quote_*` then
+   `generate_*` — show the quote and get an explicit yes; for video, quote ==
+   actual charge. Other AI-generation steps (TTS, posters, sheets, style locks,
+   MV story/script …) have no quote and bill by usage — still tell the user
+   before running them. Never auto-approve large spends on the user's behalf.
 
 3. **`retryable` decides retry-vs-change — never blind-retry.** On failure read
    the structured `fail_reason` / `retryable` (from `get_storyboards`) or the
@@ -73,6 +82,12 @@ content that will be rejected.
    user is authorized to use (their own voice, or a rights-holder's written
    consent). `clone_voice` is billed per voice (auto-refunded on failure).
    Never clone a public figure's or third party's voice without authorization.
+   Cloning needs **no character and no drama** — `clone_voice` returns a
+   `voice_id` (e.g. `lib:12`) you can immediately audition with
+   `speak_with_voice` (any text → downloadable audio URL). Bind it to a
+   character with `set_character_voice` only when you actually need it to
+   dub a shot. Always pass that same `voice_id` — never a raw number from
+   somewhere else.
 
 6. **Follow the pipeline order — do not skip.** `set_script` → `rewrite_script`
    → `extract_assets` → portraits → storyboards → frames → videos. Always
@@ -136,7 +151,8 @@ refund on failure); you never compensate manually.
 - **Shots → video**: `quote/generate_storyboards`, `get_storyboards`,
   `quote/generate_frames`, `chain_frames`, `quote/generate_videos`
 - **Audio**: `generate_tts` (required before final cut), `clone_voice`,
-  `set_character_voice`, `list_voices`, `generate_bgm`, `replace_shot_dialogue`
+  `speak_with_voice`, `set_character_voice`, `list_voices`, `delete_voice`,
+  `generate_bgm`, `replace_shot_dialogue`
 - **Finish**: `compose_episode`, `get_final_cut`, `get_export`,
   `generate_episode_poster`, `generate_cover`
 - **Edit**: `edit_video_shot`, `regenerate_shot_video`, `split_shot`,

package/dist/tools/produce.js

@@ -315,9 +315,13 @@ export function registerProduceTools(server, client) {
     }, async ({ drama_id, ...fields }) => jsonResult(await client.producePost(`/dramas/${drama_id}/products`, fields)));
     server.tool('list_products', '广告项目:列出商品库。免费。', { drama_id: z.number().int().positive() }, async ({ drama_id }) => jsonResult(await client.produceGet(`/dramas/${drama_id}/products`)));
     // ========== AI 声音克隆(voice cloning)==========
-    server.tool('clone_voice', '从一段**已授权**的音频样本克隆音色,存入你的音色库,返回音色 id。' +
+    // 音色是**独立资产**:克隆 → 试听下载,全程不需要角色。绑角色只是「要出片」时的
+    // 可选下游动作。voice_id 形如 `lib:12`,克隆/列表/试听/绑定四处同一命名空间。
+    server.tool('clone_voice', '从一段**已授权**的音频样本克隆音色,返回 voice_id。**不需要先有角色或剧目**。' +
         '⚠️ 样本必须是本人/持权人**同意授权**的声音(否则侵权,与真人/版权门同理)。' +
-        '按平台价计费(每个音色一口价);失败自动退款。之后 set_character_voice 绑到角色,generate_tts 即用它配音。', {
+        '样本会自动转写出配套文本(零样本克隆需要),10 秒左右清晰人声即可,别用纯音乐/静音。' +
+        '按平台价计费(每个音色一口价)。克隆完可直接 speak_with_voice 试听下载;' +
+        '只有要用它配音出片时,才需要再 set_character_voice 绑到角色。', {
         name: z.string().min(1).describe('音色命名(便于管理)'),
         sample_file_path: z.string().optional().describe('本地授权音频样本路径(mp3/wav/m4a,自动上传;与 sample_url 二选一)'),
         sample_url: z.string().optional().describe('已上传到 COS 的样本 URL(与 sample_file_path 二选一)'),
@@ -330,7 +334,19 @@ export function registerProduceTools(server, client) {
             throw new Error('需要 sample_file_path(本地样本自动上传)或 sample_url(已上传的 URL)');
         return jsonResult(await client.producePost('/voice-clones', notes ? { name, sample_url: url, notes } : { name, sample_url: url }));
     });
-    server.tool('list_voices', '列出我音色库里的克隆音色(id/名字/状态)。免费。', {}, async () => jsonResult(await client.produceGet('/voice-clones')));
-    server.tool('delete_voice', '删除音色库里的一个克隆音色。免费。', { voice_clone_id: z.number().int().positive() }, async ({ voice_clone_id }) => jsonResult(await client.produceDelete(`/voice-clones/${voice_clone_id}`)));
-    server.tool('set_character_voice', '把克隆音色绑到某角色(voice_clone_id 来自 clone_voice/list_voices)。绑定后 generate_tts 用它给该角色配音。免费。', { character_id: z.number().int().positive(), voice_clone_id: z.number().int().positive().describe('音色库 id') }, async ({ character_id, voice_clone_id }) => jsonResult(await client.producePost(`/characters/${character_id}/voice`, { library_id: voice_clone_id })));
+    server.tool('speak_with_voice', '让某个音色说一段任意文本,返回可下载的音频 URL。**不需要角色、不需要剧目**——' +
+        '克隆完先用它验收音色像不像,或直接把音频拿去别处用。按文本长度计费(tts 档)。', {
+        voice_id: z.string().describe('来自 clone_voice / list_voices 的 voice_id(形如 lib:12)'),
+        text: z.string().min(1).max(500).describe('要让这个音色说的话(上限 500 字)'),
+    }, async ({ voice_id, text }) => {
+        const id = String(voice_id).replace(/^lib:/, '');
+        return jsonResult(await client.producePost(`/voice-clones/${id}/speak`, { text }));
+    });
+    server.tool('list_voices', '列出可用音色:我克隆的私有音色 + 平台公共音色(voice_id/名字/试听样本)。免费。', {}, async () => jsonResult(await client.produceGet('/voice-clones')));
+    server.tool('delete_voice', '删除我音色库里的一个克隆音色(平台公共音色不可删)。免费。', { voice_id: z.string().describe('形如 lib:12') }, async ({ voice_id }) => jsonResult(await client.produceDelete(`/voice-clones/${String(voice_id).replace(/^lib:/, '')}`)));
+    server.tool('set_character_voice', '把音色绑到某角色,之后 generate_tts 用它给该角色配音。免费。' +
+        '只有要出片时才需要这步——克隆和试听都不需要角色。', {
+        character_id: z.number().int().positive(),
+        voice_id: z.string().describe('来自 clone_voice / list_voices 的 voice_id(形如 lib:12)'),
+    }, async ({ character_id, voice_id }) => jsonResult(await client.producePost(`/characters/${character_id}/voice`, { voice_id })));
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@starreel/mcp",
-  "version": "0.1.11",
+  "version": "0.1.13",
   "mcpName": "ai.starreel/starreel",
   "description": "StarReel MCP server — drive the AI short-drama production pipeline (script → storyboards → frames → video → final cut) from Claude, Cursor, or any MCP client",
   "license": "MIT",

package/server.json

@@ -2,13 +2,13 @@
   "$schema": "https://static.modelcontextprotocol.io/schemas/2025-09-29/server.schema.json",
   "name": "ai.starreel/starreel",
   "description": "Turn a script into a finished, downloadable short-drama episode — via MCP or REST.",
-  "version": "0.1.10",
+  "version": "0.1.13",
   "websiteUrl": "https://starreel.ai",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "@starreel/mcp",
-      "version": "0.1.10",
+      "version": "0.1.13",
       "transport": { "type": "stdio" },
       "environmentVariables": [
         {