mcp-multitool 0.1.0 → 0.1.1

package/README.md

@@ -4,11 +4,11 @@
 [![npm downloads](https://img.shields.io/npm/dm/mcp-multitool)](https://www.npmjs.com/package/mcp-multitool)
 [![license](https://img.shields.io/npm/l/mcp-multitool)](./LICENSE)
 
-A minimal [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server. Currently ships one tool: `wait`.
+A minimal [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server with utility tools.
 
 ## Why
 
-Some tasks genuinely need a pause — rate limits, eventual consistency, animations completing, or simply giving a background process time to settle. `mcp-multitool` gives any MCP-compatible client a reliable, configurable `wait` tool without pulling in a larger server.
+Some tasks need simple utilities that don't warrant a larger server — pausing for rate limits, deleting temp files, etc. `mcp-multitool` gives any MCP-compatible client a small set of reliable tools.
 
 ## Quick Start
 
@@ -50,6 +50,49 @@ npx mcp-multitool
 
 ## Tool Reference
 
+### `deleteFile`
+
+Delete one or more files or directories.
+
+| Parameter   | Type                 | Required | Default | Description                                           |
+| ----------- | -------------------- | -------- | ------- | ----------------------------------------------------- |
+| `paths`     | `string \| string[]` | ✅       | —       | File or directory path(s) to delete.                  |
+| `recursive` | `boolean`            | —        | `false` | If true, delete directories and contents recursively. |
+
+**Response:** `"Deleted N path(s)."`
+
+**Examples:**
+
+```
+deleteFile  paths="temp.txt"
+deleteFile  paths=["a.txt", "b.txt"]
+deleteFile  paths="build/"  recursive=true
+```
+
+---
+
+### `moveFile`
+
+Move one or more files or directories to a destination directory.
+
+| Parameter   | Type                 | Required | Default | Description                        |
+| ----------- | -------------------- | -------- | ------- | ---------------------------------- |
+| `from`      | `string \| string[]` | ✅       | —       | Source path(s) to move.            |
+| `to`        | `string`             | ✅       | —       | Destination directory.             |
+| `overwrite` | `boolean`            | —        | `false` | If true, overwrite existing files. |
+
+**Response:** `"Moved N path(s)."`
+
+**Examples:**
+
+```
+moveFile  from="old.txt"  to="archive/"
+moveFile  from=["a.txt", "b.txt"]  to="backup/"
+moveFile  from="config.json"  to="dest/"  overwrite=true
+```
+
+---
+
 ### `wait`
 
 Wait for a specified duration before continuing.
@@ -74,6 +117,8 @@ wait  durationMs=500   reason="animation to complete"
 | Variable            | Default  | Description                                                                                               |
 | ------------------- | -------- | --------------------------------------------------------------------------------------------------------- |
 | `waitMaxDurationMs` | `300000` | Override the maximum allowed `durationMs`. Must be a positive number. Server refuses to start if invalid. |
+| `deleteFile`        | _(on)_   | Set to `"false"` to disable the `deleteFile` tool at startup.                                             |
+| `moveFile`          | _(on)_   | Set to `"false"` to disable the `moveFile` tool at startup.                                               |
 | `wait`              | _(on)_   | Set to `"false"` to disable the `wait` tool at startup.                                                   |
 
 ### Disabling Individual Tools

package/dist/index.js

@@ -1,9 +1,15 @@
 #!/usr/bin/env node
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { register as registerDeleteFile } from "./tools/deleteFile.js";
+import { register as registerMoveFile } from "./tools/moveFile.js";
 import { register as registerWait } from "./tools/wait.js";
 const isEnabled = (name) => process.env[name] !== "false";
 const server = new McpServer({ name: "mcp-multitool", version: "0.1.0" });
+if (isEnabled("deleteFile"))
+    registerDeleteFile(server);
+if (isEnabled("moveFile"))
+    registerMoveFile(server);
 if (isEnabled("wait"))
     registerWait(server);
 await server.connect(new StdioServerTransport());

package/dist/tools/deleteFile.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/deleteFile.js

@@ -0,0 +1,31 @@
+import { rm } from "node:fs/promises";
+import { z } from "zod";
+const schema = z.object({
+    paths: z
+        .union([z.string(), z.array(z.string())])
+        .describe("File or directory path(s) to delete."),
+    recursive: z
+        .boolean()
+        .default(false)
+        .describe("If true, delete directories and contents recursively."),
+});
+export function register(server) {
+    server.registerTool("deleteFile", {
+        description: "Delete one or more files or directories.",
+        inputSchema: schema,
+    }, async (input) => {
+        try {
+            const paths = Array.isArray(input.paths) ? input.paths : [input.paths];
+            await Promise.all(paths.map((p) => rm(p, { recursive: input.recursive })));
+            return {
+                content: [{ type: "text", text: `Deleted ${paths.length} path(s).` }],
+            };
+        }
+        catch (err) {
+            return {
+                isError: true,
+                content: [{ type: "text", text: String(err) }],
+            };
+        }
+    });
+}

package/dist/tools/moveFile.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/moveFile.js

@@ -0,0 +1,48 @@
+import { access, rename } from "node:fs/promises";
+import { basename, join } 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 move."),
+    to: z.string().describe("Destination directory."),
+    overwrite: z
+        .boolean()
+        .default(false)
+        .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("moveFile", {
+        description: "Move one or more files or directories to a destination directory.",
+        inputSchema: schema,
+    }, async (input) => {
+        try {
+            const sources = Array.isArray(input.from) ? input.from : [input.from];
+            for (const src of sources) {
+                const dest = join(input.to, basename(src));
+                if (!input.overwrite && (await exists(dest))) {
+                    throw new Error(`Destination exists: ${dest}. Set overwrite=true to replace.`);
+                }
+                await rename(src, dest);
+            }
+            return {
+                content: [{ type: "text", text: `Moved ${sources.length} path(s).` }],
+            };
+        }
+        catch (err) {
+            return {
+                isError: true,
+                content: [{ type: "text", text: String(err) }],
+            };
+        }
+    });
+}

package/dist/tools/wait.js

@@ -26,7 +26,10 @@ const schema = z.object({
         .describe("Why the wait is needed. Max 64 characters."),
 });
 export function register(server) {
-    server.tool("wait", "Wait for a specified duration before continuing.", schema.shape, async (input) => {
+    server.registerTool("wait", {
+        description: "Wait for a specified duration before continuing.",
+        inputSchema: schema,
+    }, async (input) => {
         try {
             await new Promise((r) => setTimeout(r, input.durationMs));
             return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-multitool",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Minimal MCP server — wait tool and more.",
   "license": "MIT",
   "type": "module",
@@ -19,7 +19,11 @@
   ],
   "scripts": {
     "build": "tsc",
-    "prepublishOnly": "npm run build"
+    "lint": "eslint index.ts tsserver.ts tools/",
+    "start": "node dist/index.js",
+    "prepublishOnly": "tsc",
+    "publish": "npm publish --access public",
+    "patch": "npm version patch"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "1.29.0",