@vibeframe/mcp-server 0.108.1 → 0.109.0

package/README.md

@@ -41,7 +41,26 @@ args = ["-y", "@vibeframe/mcp-server"]
 enabled = true
 ```
 
-### Claude Desktop
+### Claude Desktop (recommended: extension)
+
+Install the prebuilt Desktop Extension — no Node, npx, or JSON editing needed:
+
+1. Download `vibeframe-<version>.mcpb` from the
+   [latest GitHub Release](https://github.com/vericontext/vibeframe/releases/latest).
+2. In Claude Desktop open **Settings → Extensions** and drag the `.mcpb` file in
+   (or double-click the file).
+3. In the extension's settings pick your **Workspace folder** (projects are
+   created there; a `.env` file in that folder is loaded for API keys) and
+   optionally paste provider keys.
+
+Rendering still needs Google Chrome and `ffmpeg` on the machine. For free local
+Kokoro TTS, run `npm i kokoro-js` once inside the workspace folder. To update,
+download the new release's `.mcpb` and install it over the old one.
+
+To build the bundle from source: `pnpm -F @vibeframe/mcp-server build:mcpb`
+(output in `packages/mcp-server/dist-mcpb/`).
+
+#### Claude Desktop (manual JSON config)
 
 Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
 
@@ -64,6 +83,10 @@ config and may not preserve a raw `cwd` field. It anchors relative project paths
 so prompts like "create a project named launch" create `launch/` under your
 workspace instead of a temporary directory.
 
+Note: some Claude Desktop builds rewrite this file from memory and can mangle
+hand-edited entries (the entry comes back as `"command": "custom"`). The
+extension install above avoids that entirely and is the recommended path.
+
 ### Cursor
 
 Add to `.cursor/mcp.json`:

package/dist/index.js

@@ -4730,13 +4730,32 @@ async function loadKokoroFactory() {
     const mod = await import("kokoro-js");
     return mod.KokoroTTS;
   } catch (err) {
+    const fallback2 = await loadKokoroFromWorkspace();
+    if (fallback2)
+      return fallback2;
     throw mapKokoroImportError(err);
   }
 }
+async function loadKokoroFromWorkspace(baseDir = process.cwd()) {
+  try {
+    const { readFile: readFile45 } = await import("node:fs/promises");
+    const { join: join44, resolve: resolve79 } = await import("node:path");
+    const { pathToFileURL } = await import("node:url");
+    const pkgDir = resolve79(baseDir, "node_modules", "kokoro-js");
+    const pkg = JSON.parse(await readFile45(join44(pkgDir, "package.json"), "utf-8"));
+    const entry = pkg.exports?.node?.import ?? pkg.exports?.default ?? pkg.module ?? pkg.main;
+    if (!entry)
+      return null;
+    const mod = await import(pathToFileURL(join44(pkgDir, entry)).href);
+    return mod.KokoroTTS ?? null;
+  } catch {
+    return null;
+  }
+}
 function mapKokoroImportError(err) {
   const code = err instanceof Error && "code" in err ? err.code : void 0;
   if (code === "ERR_MODULE_NOT_FOUND" || code === "MODULE_NOT_FOUND") {
-    return new Error("Local Kokoro TTS is unavailable: optional dependency kokoro-js is not installed (its native dependencies may have failed to build on this platform). Install it with `npm i kokoro-js`, or set ELEVENLABS_API_KEY to use the elevenlabs TTS provider instead.");
+    return new Error("Local Kokoro TTS is unavailable: optional dependency kokoro-js is not installed (its native dependencies may have failed to build on this platform). Install it with `npm i kokoro-js` \u2014 run it inside your workspace folder when using the Claude Desktop extension \u2014 or set ELEVENLABS_API_KEY to use the elevenlabs TTS provider instead.");
   }
   return err instanceof Error ? err : new Error(String(err));
 }
@@ -497687,7 +497706,23 @@ This creates a music video-style edit where cuts happen in rhythm with the music
 }
 
 // src/instructions.ts
+import { mkdirSync as mkdirSync13 } from "node:fs";
 import { isAbsolute as isAbsolute9, resolve as resolve78 } from "node:path";
+function applyWorkspaceEnv(env4 = process.env, chdir = (dir) => process.chdir(dir)) {
+  const raw2 = env4.VIBE_MCP_WORKSPACE?.trim();
+  if (!raw2) return null;
+  const dir = resolve78(raw2);
+  try {
+    mkdirSync13(dir, { recursive: true });
+    chdir(dir);
+    return dir;
+  } catch (error) {
+    console.error(
+      `[vibeframe] Could not use VIBE_MCP_WORKSPACE=${raw2} (${error instanceof Error ? error.message : String(error)}); staying in ${process.cwd()}`
+    );
+    return null;
+  }
+}
 function resolveServerWorkspaceRoot(env4 = process.env, cwd = process.cwd()) {
   const initCwd = env4.INIT_CWD?.trim();
   if (!initCwd) return cwd;
@@ -497707,10 +497742,12 @@ function buildServerInstructions(cwd = resolveServerWorkspaceRoot()) {
 console.log = (...args) => console.error(...args);
 console.info = (...args) => console.error(...args);
 console.debug = (...args) => console.error(...args);
+applyWorkspaceEnv();
 var server2 = new Server(
   {
     name: "vibeframe",
-    version: "0.1.0"
+    // Stamped with the package version by build.js at bundle time.
+    version: "0.109.0"
   },
   {
     capabilities: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibeframe/mcp-server",
-  "version": "0.108.1",
+  "version": "0.109.0",
   "description": "VibeFrame MCP Server - AI-native video editing via Model Context Protocol",
   "type": "module",
   "bin": {
@@ -60,14 +60,15 @@
     "tsx": "^4.21.0",
     "typescript": "^5.3.3",
     "vitest": "^1.2.2",
-    "@vibeframe/core": "0.108.1",
-    "@vibeframe/cli": "0.108.1"
+    "@vibeframe/core": "0.109.0",
+    "@vibeframe/cli": "0.109.0"
   },
   "engines": {
     "node": ">=20"
   },
   "scripts": {
     "build": "node build.js",
+    "build:mcpb": "node build-mcpb.js",
     "build:types": "tsc --emitDeclarationOnly",
     "dev": "tsx src/index.ts",
     "start": "node dist/index.js",