file-share-mcp 1.0.15 → 1.0.16

package/README.md

@@ -11,6 +11,11 @@ The agent can list, read, and notify about files. The user can upload, download,
   - `list_shared_files` — List all files available in the shared folder
   - `share_file` — Notify the user that a file is ready to download
   - `preview_file` — Read the content of a `.txt` or `.md` file (max 1 MB)
+  - `write_file` — Write text content to a new file in the shared folder
+  - `copy_file` — Copy a file from the agent workspace into the shared folder
+  - `download_file` — Copy a file from the shared folder to the agent machine (any file type, binary included)
+  - `create_directory` / `delete_directory` — Manage subdirectories
+  - `move_file` — Move or rename a file inside the shared folder
 - **Web GUI** — Upload, download, preview, and delete files from a browser
 - **Zero config** — works out of the box with sensible defaults (`~/.file-share-mcp`)
 - **Proxy-ready** — optional integration with the [file-share-mcp proxy](https://github.com/...)

package/dist/mcp-server.js

@@ -8,7 +8,7 @@ import { fileURLToPath } from 'url';
 import fs from 'fs';
 import { GuiLauncher, setupLogging, createLogger, reconnectGuiToolDefinition } from '@imenam/mcp-gui-interface';
 import { getConfig } from './utils/config-manager.js';
-import { getSharedFiles, validateSafePath, writeSharedFile, copyToSharedFolder, createDirectory, deleteDirectory, moveFile, } from './utils/file-manager.js';
+import { getSharedFiles, validateSafePath, writeSharedFile, copyToSharedFolder, copyFromSharedFolder, createDirectory, deleteDirectory, moveFile, } from './utils/file-manager.js';
 import { VERSION } from './version.js';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
@@ -135,6 +135,28 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                     required: ['source_path'],
                 },
             },
+            {
+                name: 'download_file',
+                description: 'Download a file from the shared folder to the agent workspace (the reverse of copy_file). Works for any file type, including binary ones.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        path: {
+                            type: 'string',
+                            description: 'Relative path of the file in the shared folder (e.g. "exports/report.pdf").',
+                        },
+                        destination_path: {
+                            type: 'string',
+                            description: 'ABSOLUTE destination path on the agent machine: either an existing directory (the file keeps its name) or the full target file path. Missing parent directories are created.',
+                        },
+                        overwrite: {
+                            type: 'boolean',
+                            description: 'Replace the destination file if it already exists. Defaults to false.',
+                        },
+                    },
+                    required: ['path', 'destination_path'],
+                },
+            },
             {
                 name: 'create_directory',
                 description: 'Create a new subdirectory inside the shared folder.',
@@ -268,6 +290,17 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     content: [{ type: 'text', text: `File "${copiedName}" copied to shared folder.` }],
                 };
             }
+            case 'download_file': {
+                const { path: relativePath, destination_path, overwrite } = z.object({
+                    path: z.string(),
+                    destination_path: z.string(),
+                    overwrite: z.boolean().optional(),
+                }).parse(args);
+                const written = copyFromSharedFolder(relativePath, destination_path, overwrite ?? false);
+                return {
+                    content: [{ type: 'text', text: `File "${relativePath}" downloaded to "${written}".` }],
+                };
+            }
             case 'create_directory': {
                 const { path: dirPath } = z.object({ path: z.string() }).parse(args);
                 createDirectory(dirPath);

package/dist/utils/file-manager.js

@@ -101,6 +101,36 @@ export function copyToSharedFolder(sourcePath, filename, relativePath = '') {
     fs.copyFileSync(sourcePath, path.join(dir, targetFilename));
     return relativePath ? `${relativePath}/${targetFilename}` : targetFilename;
 }
+/**
+ * Copy a file out of the shared folder onto the agent machine.
+ *
+ * `destination` is either a directory (existing, or written with a trailing
+ * separator) — the file then keeps its name — or the full target file path.
+ */
+export function copyFromSharedFolder(relativePath, destination, overwrite = false) {
+    const sourcePath = validateSafePath(relativePath);
+    if (!fs.existsSync(sourcePath)) {
+        throw new Error(`File not found in shared folder: ${relativePath}`);
+    }
+    if (!fs.statSync(sourcePath).isFile()) {
+        throw new Error(`Path is not a file: ${relativePath}`);
+    }
+    if (!path.isAbsolute(destination)) {
+        throw new Error(`Destination must be an absolute path: ${destination}`);
+    }
+    const looksLikeDir = destination.endsWith('/') ||
+        destination.endsWith(path.sep) ||
+        (fs.existsSync(destination) && fs.statSync(destination).isDirectory());
+    const destPath = looksLikeDir
+        ? path.join(destination, path.basename(sourcePath))
+        : destination;
+    if (!overwrite && fs.existsSync(destPath)) {
+        throw new Error(`Destination already exists: ${destPath}. Pass overwrite=true to replace it.`);
+    }
+    fs.mkdirSync(path.dirname(destPath), { recursive: true });
+    fs.copyFileSync(sourcePath, destPath);
+    return destPath;
+}
 export function createDirectory(relativePath) {
     const fullPath = validateSafePath(relativePath);
     fs.mkdirSync(fullPath, { recursive: true });

package/dist/version.js

@@ -1 +1 @@
-export const VERSION = '1.0.15';
+export const VERSION = '1.0.16';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "file-share-mcp",
-  "version": "1.0.15",
+  "version": "1.0.16",
   "description": "MCP server for bidirectional file sharing between AI agents and users, with a built-in web GUI",
   "author": "",
   "license": "ISC",