@starreel/mcp 0.1.0 → 0.1.2

package/dist/tools/produce.js

@@ -18,13 +18,47 @@ const CONFIRM_HINT = '⚠️ 批量报价确认流程:先调对应的 quote_*
     '用户明确同意后,才用返回的 quote_id 调本工具。不要擅自确认。';
 export function registerProduceTools(server, client) {
     // ---------- 建剧 ----------
+    // 参数=「项目设定 / 新建项目」页对外能设的全部通用字段(不含内部产线开关)。
+    // 尤其 setting_brief(世界观 Brief)与 ethnicity:它们是全链 ERA LOCK / 族裔单一真相源,
+    // 建剧时设好,下游剧本改写·分镜·所有出图都据它约束——不设则按剧本语言自动推断(旧行为)。
     server.tool('create_drama', '新建一部短剧(剧壳)。按 total_episodes 自动建对应数量的空集,返回 drama_id 与各集 episode_id。免费。', {
         title: z.string().describe('剧名'),
         total_episodes: z.number().int().min(1).max(200).optional().describe('集数(默认 1),自动建 N 个空集'),
         genre: z.string().optional().describe('题材,如 都市/悬疑/古装'),
         style: z.string().optional().describe('风格描述'),
         description: z.string().optional(),
-    }, async (args) => jsonResult(await client.producePost('/dramas', args)));
+        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;成本随分辨率上升)'),
+        setting_brief: z
+            .string()
+            .optional()
+            .describe('世界观 Brief:一段话锁定语言/文化/时代/地点,作为 AI 强制约束(ERA LOCK),' +
+            '影响剧本改写·分镜·所有出图。不设则按剧本语言与文化自动推断。'),
+        ethnicity: z
+            .enum([
+            'east_asian', 'southeast_asian', 'south_asian', 'central_asian',
+            'caucasian', 'middle_eastern', 'african', 'latin_american',
+            'native_american', 'aboriginal_australian', 'mixed', 'custom',
+        ])
+            .optional()
+            .describe('全剧角色族裔锁(单一真相源)。不设=按剧本自动推断;custom 时用 ethnicity_note 写自由描述'),
+        ethnicity_note: z.string().optional().describe("ethnicity='custom' 时的自由文本(如 北欧/波斯);其余取值忽略"),
+    }, async (args) => {
+        const { ethnicity, ethnicity_note, ...rest } = args;
+        const body = { ...rest };
+        // 结构化族裔锁:后端认 { code, note? };custom 无 note 派生不出锚,这里如实带上。
+        if (ethnicity) {
+            body.ethnicity_lock =
+                ethnicity === 'custom' ? { code: 'custom', note: ethnicity_note ?? '' } : { code: ethnicity };
+        }
+        return jsonResult(await client.producePost('/dramas', body));
+    });
     // ---------- 灌本 ----------
     server.tool('set_script', '给某一集设置可拍剧本文本(拆镜的输入)。免费。', {
         episode_id: z.number().int().positive(),

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "@starreel/mcp",
-  "version": "0.1.0",
-  "description": "StarReel MCP server — AI short-drama production & localization tools for Claude, Cursor, and any MCP client",
+  "version": "0.1.2",
+  "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",
   "type": "module",
   "bin": {

package/server.json

@@ -1,14 +1,14 @@
 {
   "$schema": "https://static.modelcontextprotocol.io/schemas/2025-09-29/server.schema.json",
   "name": "ai.starreel/starreel",
-  "description": "AI short-drama production pipeline: turn a script into a finished, downloadable episode — create drama, break into storyboards, generate frames and videos, and compose the final cut, all with batch quote/confirm billing.",
-  "version": "0.1.0",
+  "description": "Turn a script into a finished, downloadable short-drama episode — via MCP or REST.",
+  "version": "0.1.2",
   "websiteUrl": "https://starreel.ai",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "@starreel/mcp",
-      "version": "0.1.0",
+      "version": "0.1.2",
       "transport": { "type": "stdio" },
       "environmentVariables": [
         {