@starreel/mcp 0.1.7 → 0.1.9

package/dist/tools/produce.js

@@ -29,6 +29,11 @@ const ETHNICITY_CODES = [
     'caucasian', 'middle_eastern', 'african', 'latin_american',
     'native_american', 'aboriginal_australian', 'mixed', 'custom',
 ];
+// 画幅/分辨率的可选值 —— create_drama 与 update_project_settings **共用同一源**,防两处漂移。
+// 与后端发现接口 produce-options.ts 的 ASPECT_RATIO_OPTIONS / VIDEO_RESOLUTION_OPTIONS 键集一致
+// (video_resolution 与后端 VIDEO_RES_WHITELIST 钉死;aspect_ratio 后端柔性,这里给同一策展集)。
+const ASPECT_RATIOS = ['9:16', '16:9', '1:1', '4:5', '4:3', '21:9'];
+const VIDEO_RESOLUTIONS = ['480p', '720p', '1080p', '4k'];
 /** 把友好 ethnicity 枚举 + note 组装成后端认的结构化族裔锁 { code, note? }。 */
 function buildEthnicityLock(ethnicity, note) {
     if (!ethnicity)
@@ -49,14 +54,8 @@ export function registerProduceTools(server, client) {
         genre: z.string().optional().describe('题材,如 都市/悬疑/古装'),
         style: z.string().optional().describe('风格描述'),
         description: z.string().optional(),
-        aspect_ratio: z
-            .enum(['9:16', '16:9', '1:1', '4:5', '4:3', '21:9'])
-            .optional()
-            .describe('画幅比例(默认 9:16 竖屏短剧)'),
-        video_resolution: z
-            .enum(['480p', '720p', '1080p', '4k'])
-            .optional()
-            .describe('视频分辨率(默认 720p;成本随分辨率上升)'),
+        aspect_ratio: z.enum(ASPECT_RATIOS).optional().describe('画幅比例(默认 9:16 竖屏短剧)'),
+        video_resolution: z.enum(VIDEO_RESOLUTIONS).optional().describe('视频分辨率(默认 720p;成本随分辨率上升)'),
         setting_brief: z
             .string()
             .optional()
@@ -106,7 +105,11 @@ export function registerProduceTools(server, client) {
     server.tool('quote_storyboards', '报价:把某一集的剧本拆成分镜(storyboards)要多少点。返回 estimated_points 与 quote_id。零扣费。' +
         '拿到后把点数告诉用户征求同意,再用 quote_id 调 generate_storyboards。', { episode_id: z.number().int().positive() }, async ({ episode_id }) => jsonResult(await client.producePost(`/episodes/${episode_id}/storyboards/quote`)));
     server.tool('generate_storyboards', '确认后拆镜:后台跑(分钟级),立即返回 status:generating。用 get_storyboards 轮询,分镜出现即在生成、数量稳定即完成。' + CONFIRM_HINT, { episode_id: z.number().int().positive(), quote_id: z.string().describe('来自 quote_storyboards') }, async ({ episode_id, quote_id }) => jsonResult(await client.producePost(`/episodes/${episode_id}/storyboards/generate`, { quote_id })));
-    server.tool('get_storyboards', '读某一集的分镜列表(供审阅/查进度)。含每镜首帧(first_frame_image)与视频(video_url)是否就绪。免费。', { episode_id: z.number().int().positive() }, async ({ episode_id }) => jsonResult(await client.produceGet(`/episodes/${episode_id}/storyboards`)));
+    server.tool('get_storyboards', '读某一集的分镜列表(供审阅/查进度)。含每镜首帧(first_frame_image)与视频(video_url)是否就绪。' +
+        '★每镜还带**结构化状态**:frame_status/video_status(ready/pending/authorizing/rejected/failed/none)、' +
+        'fail_reason(sensitive/text_sensitive/copyright/face_mismatch/account_overdue/quota_full/authorizing/' +
+        'insufficient_credits/transient)、retryable(true=可重试;false=改内容换图,重试无效)、fail_hint(人读文案)。' +
+        '照 retryable 判该重试还是该改内容,别解析中文。免费。', { episode_id: z.number().int().positive() }, async ({ episode_id }) => jsonResult(await client.produceGet(`/episodes/${episode_id}/storyboards`)));
     // ---------- 出首帧(frames) ----------
     server.tool('quote_frames', '报价:给某一集缺首帧的分镜批量出首帧要多少点。返回 frames_to_generate、estimated_points、quote_id。零扣费。', { episode_id: z.number().int().positive() }, async ({ episode_id }) => jsonResult(await client.producePost(`/episodes/${episode_id}/frames/quote`)));
     server.tool('generate_frames', '确认后批量出首帧:后台异步。用 get_storyboards 轮询,first_frame_image 逐镜填充即完成。' +
@@ -129,8 +132,8 @@ export function registerProduceTools(server, client) {
         style: z.string().optional(),
         description: z.string().optional(),
         tags: z.array(z.string()).optional(),
-        aspect_ratio: z.enum(['9:16', '16:9', '1:1', '4:5', '4:3', '21:9']).optional(),
-        video_resolution: z.enum(['480p', '720p', '1080p', '4k']).optional(),
+        aspect_ratio: z.enum(ASPECT_RATIOS).optional(),
+        video_resolution: z.enum(VIDEO_RESOLUTIONS).optional(),
         setting_brief: z.string().optional().describe('世界观 Brief(ERA LOCK)'),
         ethnicity: z.enum(ETHNICITY_CODES).optional().describe('角色族裔锁'),
         ethnicity_note: z.string().optional(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@starreel/mcp",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "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.7",
+  "version": "0.1.9",
   "websiteUrl": "https://starreel.ai",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "@starreel/mcp",
-      "version": "0.1.7",
+      "version": "0.1.9",
       "transport": { "type": "stdio" },
       "environmentVariables": [
         {