@visionengine/remotion-file-bridge 1.0.0 → 1.0.1

package/README-zh.md

@@ -20,6 +20,7 @@
 - `read_file`：直接读取文本文件，或返回二进制资源的预览/下载地址。
 - `download_file`：把远端工作区文件下载到本地 `WORKDIR`。
 - `save_file`：把本地文件、文本、base64 内容或远端 URL 保存到工作区。
+- `delete_file`：按完整工作区相对路径删除远端文件。该操作需要使用用户 API KEY 做后端校验。
 
 ## 后端依赖
 
@@ -27,5 +28,26 @@
 
 - `GET /api/v1/auth/me`
 - `GET /api/v1/files/list`
+- `DELETE /api/v1/files/delete`
 - `GET /shared/{userId}/{path}`
-- `POST /save`
+- `POST /save`
+
+
+```json
+{
+  "mcpServers": {
+    "ve-remotion-file-bridge": {
+      "type": "local",
+      "command": "npx",
+      "args": ["-y", "@visionengine/remotion-file-bridge@latest"],
+      "transport": "stdio",
+      "env": {
+        "API_KEY": "你的API密钥"
+      }
+    }
+  }
+}
+// npx -y @visionengine/remotion-file-bridge@latest
+// npm info @visionengine/remotion-file-bridge@latest
+```
+

package/README.md

@@ -20,6 +20,7 @@ Required:
 - `read_file`: read text files directly, or return preview/download URLs for binary assets.
 - `download_file`: download a remote workspace file into local `WORKDIR`.
 - `save_file`: save local files, text, base64 content, or remote URLs into the workspace.
+- `delete_file`: delete a remote workspace file by full workspace-relative path. This operation requires API key authentication.
 
 ## Backend requirements
 
@@ -27,5 +28,6 @@ This MCP package depends on these backend endpoints:
 
 - `GET /api/v1/auth/me`
 - `GET /api/v1/files/list`
+- `DELETE /api/v1/files/delete`
 - `GET /shared/{userId}/{path}`
 - `POST /save`

package/dist/client.js

@@ -185,3 +185,27 @@ export async function saveProjectFile(args) {
         },
     };
 }
+export async function deleteProjectFile(args) {
+    const userId = await resolveUserId(args.userId);
+    const workspacePath = normalizeWorkspacePath(args.path, userId);
+    if (!workspacePath || workspacePath === '.') {
+        throw new Error('path must be a full workspace-relative file path');
+    }
+    const query = new URLSearchParams({ path: workspacePath });
+    const response = await fetch(`${getBaseUrl()}/api/v1/files/delete?${query.toString()}`, {
+        method: 'DELETE',
+        headers: buildAuthHeaders(),
+    });
+    if (!response.ok) {
+        throw new Error(`Failed to delete file: ${response.status} ${await response.text()}`);
+    }
+    const payload = await response.json();
+    return {
+        success: payload.success,
+        userId,
+        workspacePath: payload.path,
+        metadata: {
+            deleted: payload.deleted,
+        },
+    };
+}

package/dist/server.js

@@ -1,13 +1,14 @@
 import { FastMCP } from 'fastmcp';
 import { z } from 'zod';
-import { downloadProjectFile, listProjectFiles, readProjectFile, saveProjectFile } from './client.js';
+import { deleteProjectFile, downloadProjectFile, listProjectFiles, readProjectFile, saveProjectFile } from './client.js';
 const server = new FastMCP({
     name: 'VE Remotion File Bridge',
     version: '1.0.0',
+    instructions: 'Use this MCP only when the user explicitly asks to operate files in the remote Remotion project workspace, VEC cloud workspace, cloud project files, or other clearly remote workspace assets. Do not use it for ordinary local file operations unless the user clearly indicates they want to work with the remote VEC workspace.',
 });
 server.addTool({
     name: 'list_files',
-    description: 'List files in the current Remotion project workspace via the backend file bridge API.',
+    description: 'Use only when the user explicitly wants to browse files in the remote Remotion/VEC cloud workspace. Lists files from the current remote project workspace via the backend file bridge API, not the ordinary local filesystem.',
     annotations: { title: 'List Remotion Project Files', readOnlyHint: true, openWorldHint: false },
     parameters: z.object({
         userId: z.string().optional().describe('Optional user id override. Normally resolved automatically from API key.'),
@@ -22,7 +23,7 @@ server.addTool({
 });
 server.addTool({
     name: 'read_file',
-    description: 'Read a project file as text when suitable, or return preview/download URLs for binary files.',
+    description: 'Use only when the user explicitly wants to read a file from the remote Remotion/VEC cloud workspace. Reads remote text files when suitable, or returns preview/download URLs for remote binary assets.',
     annotations: { title: 'Read Remotion Project File', readOnlyHint: true, openWorldHint: false },
     parameters: z.object({
         userId: z.string().optional(),
@@ -34,7 +35,7 @@ server.addTool({
 });
 server.addTool({
     name: 'download_file',
-    description: 'Download a remote workspace file into the local WORKDIR.',
+    description: 'Use only when the user explicitly wants to fetch a file from the remote Remotion/VEC cloud workspace into the local environment. Downloads a remote workspace file into local WORKDIR.',
     annotations: { title: 'Download Remotion Project File', readOnlyHint: false, openWorldHint: false },
     parameters: z.object({
         userId: z.string().optional(),
@@ -45,7 +46,7 @@ server.addTool({
 });
 server.addTool({
     name: 'save_file',
-    description: 'Save local files, text, base64 payloads, or remote URLs into the current user Remotion workspace.',
+    description: 'Use only when the user explicitly wants to save or upload content into the remote Remotion/VEC cloud workspace. Saves local files, text, base64 payloads, or remote URLs into the current user remote workspace.',
     annotations: { title: 'Save Remotion Project File', readOnlyHint: false, openWorldHint: true },
     parameters: z.object({
         userId: z.string().optional(),
@@ -59,4 +60,14 @@ server.addTool({
     }),
     execute: async (args) => JSON.stringify(await saveProjectFile(args), null, 2),
 });
+server.addTool({
+    name: 'delete_file',
+    description: 'Use only when the user explicitly wants to delete a file from the remote Remotion/VEC cloud workspace. Deletes a file in the current user remote workspace and requires the full workspace-relative file path.',
+    annotations: { title: 'Delete Remotion Project File', readOnlyHint: false, openWorldHint: false },
+    parameters: z.object({
+        userId: z.string().optional(),
+        path: z.string().min(1).describe('Full workspace-relative file path to delete, such as src/Root.tsx or public/videos/demo.mp4.'),
+    }),
+    execute: async (args) => JSON.stringify(await deleteProjectFile(args), null, 2),
+});
 export { server };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@visionengine/remotion-file-bridge",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "VisionEngine Remotion File Bridge MCP Server",
   "main": "dist/index.js",
   "type": "module",