@craftstory/mcp 0.1.0 → 0.1.1

package/README.md

@@ -61,7 +61,7 @@ Plus the prompt `talking_video_from_photo` (script + photo) that walks the model
 
 The assistant will: `list_voices` -> `create_audio_clip` -> `wait_for_job(audio-clip)` -> `preview_cost` -> `create_craftstory2_video` (resolution `720_1280`, gestures `calm`) -> `wait_for_job(craftstory-2)` a few times -> `get_job_result` -> the video URL.
 
-Long jobs: `wait_for_job` never blocks longer than `timeout_s` (max 55 s, under the 60 s tool-call limit of most clients). A CraftStory 2.0 video needs several calls; that is by design so agent runtimes do not time out.
+Long jobs: `wait_for_job` returns after at most `timeout_s` (max 55 s) plus one in-flight status request (25 s HTTP timeout), which keeps it under the 60 s tool-call limit of most clients in normal conditions. A CraftStory 2.0 video needs several calls; that is by design so agent runtimes do not time out.
 
 ## Local files vs URLs
 

package/dist/client.js

@@ -5,7 +5,9 @@
 import { readFile } from "node:fs/promises";
 import { basename } from "node:path";
 export const DEFAULT_BASE = "https://api.craftstory.com/api/v1";
-export const USER_AGENT = "craftstory-mcp/0.1.0";
+export const USER_AGENT = "craftstory-mcp/0.1.1";
+/** Per-request HTTP timeout; keeps every tool call well under MCP clients' ~60 s limit. */
+export const REQUEST_TIMEOUT_MS = 25_000;
 export class ApiError extends Error {
     status;
     body;
@@ -47,10 +49,12 @@ export class CraftStoryClient {
         }
         let res;
         try {
-            res = await this.fetchImpl(`${this.base}${path}`, { method, headers, body: payload });
+            res = await this.fetchImpl(`${this.base}${path}`, { method, headers, body: payload, signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS) });
         }
         catch (e) {
             // Node's fetch hides the reason behind "fetch failed"; surface the cause (DNS, TLS, reset...).
+            if (e.name === "TimeoutError")
+                throw new Error(`Timeout after ${REQUEST_TIMEOUT_MS / 1000}s calling ${method} ${path}`);
             const cause = e.cause;
             throw new Error(`Network error calling ${method} ${path}: ${cause?.code ?? ""} ${cause?.message ?? e.message}`.trim());
         }

package/dist/server.js

@@ -14,7 +14,7 @@ const JOB_KINDS = ["craftstory-2", "minimax-h3", "audio-clip"];
 const text = (data) => ({ content: [{ type: "text", text: typeof data === "string" ? data : JSON.stringify(data, null, 2) }] });
 const fail = (err) => ({ isError: true, content: [{ type: "text", text: err instanceof Error ? err.message : String(err) }] });
 export function buildServer(client) {
-    const server = new McpServer({ name: "craftstory", version: "0.1.0" });
+    const server = new McpServer({ name: "craftstory", version: "0.1.1" });
     server.registerTool("list_models", {
         title: "List CraftStory video models",
         description: "Catalogue of the video models behind this server with their status, modes, limits and credit prices. " +
@@ -222,6 +222,8 @@ export function buildServer(client) {
         let last;
         try {
             while (true) {
+                if (Date.now() >= deadline && last)
+                    return text({ state: "running", ...last, hint: "still running - call wait_for_job again" });
                 last = await client.getStatus(model, id);
                 const state = classify(last.status);
                 if (token !== undefined) {
@@ -234,9 +236,10 @@ export function buildServer(client) {
                     const result = state === "done" ? await client.getResult(model, id) : undefined;
                     return text({ state, ...last, ...(result ? { result } : {}) });
                 }
-                if (Date.now() >= deadline)
+                const remaining = deadline - Date.now();
+                if (remaining <= 0)
                     return text({ state: "running", ...last, hint: "still running - call wait_for_job again" });
-                await new Promise((r) => setTimeout(r, model === "audio-clip" ? 2000 : 5000));
+                await new Promise((r) => setTimeout(r, Math.min(model === "audio-clip" ? 2000 : 5000, remaining)));
             }
         }
         catch (e) {

package/package.json

@@ -1,21 +1,37 @@
 {
   "name": "@craftstory/mcp",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "MCP server for the CraftStory API: talking-avatar videos from a photo (CraftStory 2.0) and short clips with generated sound (MiniMax H3), from Claude, Cursor and other MCP clients.",
   "type": "module",
-  "bin": { "craftstory-mcp": "dist/index.js" },
+  "bin": {
+    "craftstory-mcp": "dist/index.js"
+  },
   "main": "dist/index.js",
-  "files": ["dist", "README.md", "LICENSE"],
-  "engines": { "node": ">=18" },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
   "scripts": {
     "build": "tsc -p tsconfig.json && chmod +x dist/index.js",
     "start": "node dist/index.js",
     "test": "node --import tsx --test test/*.test.ts",
     "smoke": "tsx test/smoke.ts"
   },
-  "keywords": ["mcp", "model-context-protocol", "craftstory", "ai-video", "talking-avatar", "lip-sync", "text-to-video", "minimax"],
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "craftstory",
+    "ai-video",
+    "talking-avatar",
+    "lip-sync",
+    "text-to-video",
+    "minimax"
+  ],
   "license": "MIT",
-  "repository": { "type": "git", "url": "https://gitlab.itseez3d.com/craftstory/craftstory-mcp" },
   "homepage": "https://craftstory.com",
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.30.0",
@@ -25,5 +41,8 @@
     "@types/node": "^22.0.0",
     "tsx": "^4.19.0",
     "typescript": "^5.6.0"
+  },
+  "bugs": {
+    "url": "https://api.craftstory.com/api/v1/docs/public/"
   }
 }