mcp-multitool 0.1.10 → 0.1.11

package/README.md

@@ -12,6 +12,7 @@ A [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server with **
 | ----------------- | ------------------------------------------------------- |
 | `astGrepSearch`   | Search code using AST patterns                          |
 | `checkFileOrDir`  | Check if a file or directory exists and return metadata |
+| `cloneFileOrDir`  | Copy one or more files or directories to a destination  |
 | `deleteFileOrDir` | Delete one or more files or directories                 |
 | `moveFileOrDir`   | Move one or more files or directories to a new location |
 | `readLogFile`     | Read and compress logs with 60-90% token reduction      |
@@ -104,6 +105,28 @@ checkFileOrDir  path="./src/index.ts"
 
 ---
 
+### `cloneFileOrDir`
+
+Copy one or more files or directories to a destination directory.
+
+| Parameter   | Type                 | Required | Description                        |
+| ----------- | -------------------- | -------- | ---------------------------------- |
+| `from`      | `string \| string[]` | ✅       | Source path(s) to clone.           |
+| `to`        | `string`             | ✅       | Destination directory.             |
+| `overwrite` | `boolean`            | ✅       | If true, overwrite existing files. |
+
+**Response:** JSON array of `{source, destination}` objects showing each cloned path.
+
+**Examples:**
+
+```
+cloneFileOrDir  from="config.json"  to="backup/"  overwrite=false
+cloneFileOrDir  from=["a.txt", "b.txt"]  to="copies/"  overwrite=false
+cloneFileOrDir  from="src/"  to="archive/"  overwrite=true
+```
+
+---
+
 ### `deleteFileOrDir`
 
 Delete one or more files or directories.
@@ -240,6 +263,7 @@ wait  durationSeconds=1  reason="animation to complete"
 | `readLogFileTimeoutMs`   | `5000`  | Override the timeout for `readLogFile` processing in milliseconds. Server refuses to start if invalid.         |
 | `astGrepSearch`          | _(on)_  | Set to `"false"` to disable the `astGrepSearch` tool at startup.                                               |
 | `checkFileOrDir`         | _(on)_  | Set to `"false"` to disable the `checkFileOrDir` tool at startup.                                              |
+| `cloneFileOrDir`         | _(on)_  | Set to `"false"` to disable the `cloneFileOrDir` tool at startup.                                              |
 | `deleteFileOrDir`        | _(on)_  | Set to `"false"` to disable the `deleteFileOrDir` tool at startup.                                             |
 | `moveFileOrDir`          | _(on)_  | Set to `"false"` to disable the `moveFileOrDir` tool at startup.                                               |
 | `readLogFile`            | _(on)_  | Set to `"false"` to disable the `readLogFile` tool at startup.                                                 |

package/dist/index.js

@@ -4,6 +4,7 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { register as registerAstGrepSearch } from "./tools/astGrepSearch.js";
 import { register as registerCheckFileOrDir } from "./tools/checkFileOrDir.js";
+import { register as registerCloneFileOrDir } from "./tools/cloneFileOrDir.js";
 import { register as registerDeleteFileOrDir } from "./tools/deleteFileOrDir.js";
 import { register as registerMoveFileOrDir } from "./tools/moveFileOrDir.js";
 import { register as registerReadLogFile } from "./tools/readLogFile.js";
@@ -17,6 +18,8 @@ if (isEnabled("astGrepSearch"))
     registerAstGrepSearch(server);
 if (isEnabled("checkFileOrDir"))
     registerCheckFileOrDir(server);
+if (isEnabled("cloneFileOrDir"))
+    registerCloneFileOrDir(server);
 if (isEnabled("deleteFileOrDir"))
     registerDeleteFileOrDir(server);
 if (isEnabled("moveFileOrDir"))

package/dist/tools/cloneFileOrDir.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function register(server: McpServer): void;

package/dist/tools/cloneFileOrDir.js

@@ -0,0 +1,55 @@
+import { access, cp } from "node:fs/promises";
+import { basename, join, resolve } from "node:path";
+import { z } from "zod";
+const schema = z.object({
+    from: z
+        .union([z.string(), z.array(z.string())])
+        .describe("Source path(s) to clone."),
+    to: z.string().describe("Destination directory."),
+    overwrite: z.boolean().describe("If true, overwrite existing files."),
+});
+async function exists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function register(server) {
+    server.registerTool("cloneFileOrDir", {
+        description: "Copy one or more files or directories to a destination directory.",
+        inputSchema: schema,
+        annotations: {
+            destructiveHint: true,
+            openWorldHint: false,
+        },
+    }, async (input) => {
+        try {
+            const sources = Array.isArray(input.from) ? input.from : [input.from];
+            const results = [];
+            for (const src of sources) {
+                const srcPath = resolve(process.cwd(), src);
+                const destPath = join(resolve(process.cwd(), input.to), basename(src));
+                if (!input.overwrite && (await exists(destPath))) {
+                    throw new Error(`Destination exists: ${destPath}. Set overwrite=true to replace.`);
+                }
+                await cp(srcPath, destPath, {
+                    recursive: true,
+                    force: input.overwrite,
+                });
+                results.push({ source: srcPath, destination: destPath });
+            }
+            return {
+                content: [{ type: "text", text: JSON.stringify(results, null, 2) }],
+            };
+        }
+        catch (err) {
+            return {
+                isError: true,
+                content: [{ type: "text", text: String(err) }],
+            };
+        }
+    });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-multitool",
-  "version": "0.1.10",
+  "version": "0.1.11",
   "description": "MCP server with file operations (delete, move) and timing utilities.",
   "license": "MIT",
   "type": "module",