@starreel/mcp 0.1.3 → 0.1.4

package/dist/client.js

@@ -11,7 +11,16 @@
  *     任何厂商直链字段)。
  */
 import { createReadStream, statSync } from 'node:fs';
+import { basename } from 'node:path';
 import { Readable } from 'node:stream';
+/** 扩展名 → MIME(presign 需要 content_type)。 */
+const MIME_BY_EXT = {
+    '.jpg': 'image/jpeg', '.jpeg': 'image/jpeg', '.png': 'image/png', '.webp': 'image/webp',
+    '.gif': 'image/gif', '.bmp': 'image/bmp',
+    '.mp4': 'video/mp4', '.mov': 'video/quicktime',
+    '.mp3': 'audio/mpeg', '.wav': 'audio/wav', '.m4a': 'audio/mp4', '.aac': 'audio/aac',
+    '.ogg': 'audio/ogg', '.flac': 'audio/flac',
+};
 const AUTH_BASE = process.env.STARREEL_AUTH_BASE ?? 'https://api.shortreelai.com';
 const LOC_BASE = process.env.STARREEL_LOC_BASE ?? 'https://translator.starreel.ai';
 export class StarReelClient {
@@ -130,11 +139,11 @@ export class StarReelClient {
      * 把本地文件流式 PUT 到 COS 预签名 URL(字节不经我们任何服务器)。
      * Content-Length 必带 —— 预签名 PUT 对 chunked 编码不友好。
      */
-    async uploadFile(uploadUrl, filePath) {
+    async uploadFile(uploadUrl, filePath, extraHeaders = {}) {
         const size = statSync(filePath).size;
         const res = await fetch(uploadUrl, {
             method: 'PUT',
-            headers: { 'content-length': String(size) },
+            headers: { 'content-length': String(size), ...extraHeaders },
             body: Readable.toWeb(createReadStream(filePath)),
             // Node fetch(undici) 流式请求体必须显式声明半双工
             duplex: 'half',
@@ -142,4 +151,19 @@ export class StarReelClient {
         if (!res.ok)
             throw new Error(`upload failed: HTTP ${res.status} (${(await res.text()).slice(0, 200)})`);
     }
+    /**
+     * 本地文件 → 我方 COS:presign(门面 /upload-url)→ 直传字节到预签名 URL → 返回 public_url。
+     * 字节不经我们的业务服务器,只走 COS。kind: image(默认)/video/audio。
+     */
+    async uploadLocalFile(filePath, kind = 'image') {
+        const size = statSync(filePath).size;
+        const filename = basename(filePath);
+        const ext = (filename.match(/\.[a-z0-9]+$/i)?.[0] || '').toLowerCase();
+        const content_type = MIME_BY_EXT[ext] || 'application/octet-stream';
+        const res = await this.producePost('/upload-url', { filename, content_type, size, kind });
+        // presign 可能要求 PUT 带特定头(content-type 等)——按 presign 返回的 headers 送;
+        // 未返回则至少带 content-type(COS 签名常把它纳入)。
+        await this.uploadFile(res.put_url, filePath, res.headers ?? { 'content-type': content_type });
+        return res.public_url;
+    }
 }

package/dist/tools/produce.js

@@ -175,4 +175,65 @@ export function registerProduceTools(server, client) {
     server.tool('generate_motion_templates', '从分镜自动抽取动作模板(统一全片运动语言)。**需先有分镜**(先 generate_storyboards)。文本步后付不欠费。', { drama_id: z.number().int().positive() }, async ({ drama_id }) => jsonResult(await client.producePost(`/dramas/${drama_id}/motion-templates`)));
     server.tool('quote_scene_images', '报价:给缺图场景批量出场景图要多少点。返回 images_to_generate、estimated_points、quote_id。零扣费。', { drama_id: z.number().int().positive() }, async ({ drama_id }) => jsonResult(await client.producePost(`/dramas/${drama_id}/scene-images/quote`)));
     server.tool('generate_scene_images', '确认后批量出场景图:后台异步。' + CONFIRM_HINT, { drama_id: z.number().int().positive(), quote_id: z.string().describe('来自 quote_scene_images') }, async ({ drama_id, quote_id }) => jsonResult(await client.producePost(`/dramas/${drama_id}/scene-images/generate`, { quote_id })));
+    // ========== A · 客户上传自己的图片 ==========
+    server.tool('upload_image', '把本地图片上传到我方 COS,返回 image_url(字节直传 COS、不过业务服务器)。' +
+        '用于给视频编辑当参考图,或先拿 URL 再登记。免费。', {
+        file_path: z.string().describe('本地图片绝对路径(jpg/png/webp)'),
+        kind: z.enum(['image', 'video', 'audio']).optional().describe('默认 image;视频编辑的参考视频/音频可选 video/audio'),
+    }, async ({ file_path, kind }) => {
+        const url = await client.uploadLocalFile(file_path, kind ?? 'image');
+        return jsonResult({ image_url: url });
+    });
+    server.tool('set_character_portrait', '用客户自有图片作为角色定妆图(身份锚,优先级高于 AI 生成;之后 AI 重生默认不覆盖)。' +
+        '自动上传本地图 + 登记。免费。', { character_id: z.number().int().positive(), file_path: z.string().describe('本地定妆图路径') }, async ({ character_id, file_path }) => {
+        const image_url = await client.uploadLocalFile(file_path, 'image');
+        return jsonResult(await client.producePost(`/characters/${character_id}/portrait`, { image_url }));
+    });
+    server.tool('upload_shot_frame', '用客户自有图片作为某镜的首帧或尾帧(会把该镜已有视频标为过期待重生)。自动上传+登记。免费。', {
+        storyboard_id: z.number().int().positive(),
+        file_path: z.string().describe('本地帧图路径'),
+        frame_type: z.enum(['first_frame', 'last_frame']).optional().describe('默认 first_frame'),
+    }, async ({ storyboard_id, file_path, frame_type }) => {
+        const image_url = await client.uploadLocalFile(file_path, 'image');
+        return jsonResult(await client.producePost(`/storyboards/${storyboard_id}/frame`, { image_url, frame_type: frame_type ?? 'first_frame' }));
+    });
+    server.tool('upload_scene_image', '用客户自有图片作为某场景的参考图。自动上传+登记。免费。', { scene_id: z.number().int().positive(), file_path: z.string().describe('本地场景图路径') }, async ({ scene_id, file_path }) => {
+        const image_url = await client.uploadLocalFile(file_path, 'image');
+        return jsonResult(await client.producePost(`/scenes/${scene_id}/image`, { image_url }));
+    });
+    server.tool('upload_prop_sheet', '用客户自有图片作为某道具的设定图。自动上传+登记。免费。', { prop_id: z.number().int().positive(), file_path: z.string().describe('本地道具图路径') }, async ({ prop_id, file_path }) => {
+        const image_url = await client.uploadLocalFile(file_path, 'image');
+        return jsonResult(await client.producePost(`/props/${prop_id}/sheet`, { image_url }));
+    });
+    // ========== B · 视频就地编辑 / 剪辑 ==========
+    server.tool('get_edit_capabilities', '查视频编辑能力开关(就地编辑 / 区间替换是否可用)。免费。', {}, async () => jsonResult(await client.produceGet('/videos/edit-capabilities')));
+    server.tool('quote_edit_video_shot', '报价:对某镜做就地编辑/区间替换(Seedance 2.5)要多少点。返回 quote_id。零扣费。' +
+        '本镜须已有视频。', { storyboard_id: z.number().int().positive() }, async ({ storyboard_id }) => jsonResult(await client.producePost(`/storyboards/${storyboard_id}/edit/quote`)));
+    server.tool('edit_video_shot', '确认后就地编辑某镜视频:按 instruction 改,可带参考图/视频/音频,或用 start_sec/end_sec 做区间替换。' +
+        CONFIRM_HINT, {
+        storyboard_id: z.number().int().positive(),
+        quote_id: z.string().describe('来自 quote_edit_video_shot'),
+        instruction: z.string().describe('编辑指令(如"把背景换成夜晚")'),
+        reference_image_urls: z.array(z.string()).max(9).optional().describe('参考图 URL(先 upload_image 拿)'),
+        reference_video_urls: z.array(z.string()).max(2).optional(),
+        reference_audio_urls: z.array(z.string()).max(3).optional(),
+        start_sec: z.number().optional().describe('区间替换起点秒'),
+        end_sec: z.number().optional().describe('区间替换终点秒'),
+    }, async ({ storyboard_id, ...rest }) => jsonResult(await client.producePost(`/storyboards/${storyboard_id}/edit/generate`, rest)));
+    server.tool('quote_regenerate_shot_video', '报价:重生某镜视频要多少点。返回 quote_id。零扣费。', { storyboard_id: z.number().int().positive() }, async ({ storyboard_id }) => jsonResult(await client.producePost(`/storyboards/${storyboard_id}/regen/quote`)));
+    server.tool('regenerate_shot_video', '确认后重生某镜视频(可选新 prompt)。' + CONFIRM_HINT, {
+        storyboard_id: z.number().int().positive(),
+        quote_id: z.string().describe('来自 quote_regenerate_shot_video'),
+        prompt: z.string().optional().describe('可选:覆盖该镜视频 prompt'),
+    }, async ({ storyboard_id, quote_id, prompt }) => jsonResult(await client.producePost(`/storyboards/${storyboard_id}/regen/generate`, prompt ? { quote_id, prompt } : { quote_id })));
+    server.tool('split_shot', '把某镜按首尾帧拆成两镜(结构操作)。免费。', { storyboard_id: z.number().int().positive() }, async ({ storyboard_id }) => jsonResult(await client.producePost(`/storyboards/${storyboard_id}/split`)));
+    server.tool('trim_shot', '裁剪某镜时长(in_ms/out_ms)。免费;返回后需 rerender_episode 重拼成片。', {
+        storyboard_id: z.number().int().positive(),
+        in_ms: z.number().int().min(0).optional(),
+        out_ms: z.number().int().min(0).optional(),
+    }, async ({ storyboard_id, in_ms, out_ms }) => jsonResult(await client.producePut(`/storyboards/${storyboard_id}/trim`, { in_ms, out_ms })));
+    server.tool('rerender_episode', '按当前 timeline 重拼成片(改完镜/裁剪后用)。**免费**(纯 ffmpeg+COS),后台异步。', { episode_id: z.number().int().positive() }, async ({ episode_id }) => jsonResult(await client.producePost(`/episodes/${episode_id}/re-render`)));
+    server.tool('replace_shot_dialogue', '换某镜对白音色/声线(转写+克隆重配)。后台异步,按用量后付不欠费。要求本镜有原声视频+角色声线定妆音。', { storyboard_id: z.number().int().positive() }, async ({ storyboard_id }) => jsonResult(await client.producePost(`/storyboards/${storyboard_id}/dialogue-replace`)));
+    server.tool('generate_bgm', '给整集生成/更换 AI 配乐(按情绪弧线)。后台异步,按用量后付不欠费。', { episode_id: z.number().int().positive() }, async ({ episode_id }) => jsonResult(await client.producePost(`/episodes/${episode_id}/bgm`)));
+    server.tool('translate_subtitles', '把某集字幕翻译成第二语言并开启双语。后台异步,按用量后付不欠费。', { episode_id: z.number().int().positive(), lang: z.string().describe('目标语言(如 en/ja/ko)') }, async ({ episode_id, lang }) => jsonResult(await client.producePost(`/episodes/${episode_id}/subtitles/translate`, { lang })));
 }

package/package.json

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