mcp-multitool 0.1.9 → 0.1.11

package/README.md

@@ -10,7 +10,9 @@ A [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server with **
 
 | Tool              | Description                                             |
 | ----------------- | ------------------------------------------------------- |
+| `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      |
@@ -61,6 +63,28 @@ npx mcp-multitool
 
 ## Tool Reference
 
+### `astGrepSearch`
+
+Search code using AST patterns. Matches code structure, not text. Use `$VAR` for single-node wildcards (e.g., `console.log($ARG)`), `$$$VAR` for multiple nodes. More precise than regex for code search.
+
+| Parameter | Type                 | Required | Description                                                                      |
+| --------- | -------------------- | -------- | -------------------------------------------------------------------------------- |
+| `pattern` | `string`             | ✅       | AST pattern to match. Use `$VAR` for metavariables, `$$$VAR` for multiple nodes. |
+| `paths`   | `string \| string[]` | ✅       | File or directory path(s) to search. Directories are searched recursively.       |
+| `lang`    | `string`             | ✅       | Language to parse. Built-in: `javascript`, `typescript`, `tsx`, `html`, `css`.   |
+
+**Response:** JSON object with `results` array (each with `file`, `range`, `text`) and `errors` array.
+
+**Examples:**
+
+```
+astGrepSearch  pattern="console.log($ARG)"  paths="src"  lang="typescript"
+astGrepSearch  pattern="function $NAME($$$PARAMS) { $$$BODY }"  paths=["lib", "src"]  lang="javascript"
+astGrepSearch  pattern="<div $$$ATTRS>$$$CHILDREN</div>"  paths="components"  lang="tsx"
+```
+
+---
+
 ### `checkFileOrDir`
 
 Check if a file or directory exists and return its metadata (type, size, timestamps, permissions). Returns an error if the path does not exist.
@@ -81,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.
@@ -215,7 +261,9 @@ wait  durationSeconds=1  reason="animation to complete"
 | ------------------------ | ------- | -------------------------------------------------------------------------------------------------------------- |
 | `waitMaxDurationSeconds` | `300`   | Override the maximum allowed `durationSeconds`. Must be a positive number. Server refuses to start if invalid. |
 | `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

@@ -2,7 +2,9 @@
 import { createRequire } from "node:module";
 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";
@@ -12,8 +14,12 @@ const require = createRequire(import.meta.url);
 const { version } = require("../package.json");
 const isEnabled = (name) => process.env[name] !== "false";
 const server = new McpServer({ name: "mcp-multitool", version });
+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/astGrepSearch.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/astGrepSearch.js

@@ -0,0 +1,76 @@
+import { z } from "zod";
+import { findInFiles } from "@ast-grep/napi";
+const builtinLangs = [
+    "javascript",
+    "typescript",
+    "tsx",
+    "html",
+    "css",
+];
+const langMap = {
+    javascript: "JavaScript",
+    typescript: "TypeScript",
+    tsx: "Tsx",
+    html: "Html",
+    css: "Css",
+};
+const schema = z.object({
+    pattern: z
+        .string()
+        .min(1)
+        .describe("AST pattern to match. Use $VAR for single-node metavariables, $$$VAR for multiple nodes. Example: 'console.log($ARG)' matches any console.log call."),
+    paths: z
+        .union([z.string(), z.array(z.string())])
+        .describe("File or directory path(s) to search. Directories are searched recursively."),
+    lang: z
+        .enum(builtinLangs)
+        .describe("Language to parse. Built-in: javascript, typescript, tsx, html, css"),
+});
+export function register(server) {
+    server.registerTool("astGrepSearch", {
+        description: "Search code using AST patterns. Matches code structure, not text. " +
+            "Use $VAR for single-node wildcards (e.g., 'console.log($ARG)'), $$$VAR for multiple nodes. " +
+            "More precise than regex for code search. " +
+            "Languages: javascript, typescript, tsx, html, css.",
+        inputSchema: schema,
+        annotations: { readOnlyHint: true, openWorldHint: false },
+    }, async (input) => {
+        try {
+            const lang = langMap[input.lang];
+            const paths = Array.isArray(input.paths) ? input.paths : [input.paths];
+            const results = [];
+            const errors = [];
+            await findInFiles(lang, {
+                paths,
+                matcher: { rule: { pattern: input.pattern } },
+            }, (err, nodes) => {
+                if (err) {
+                    errors.push(err);
+                    return;
+                }
+                const file = nodes[0]?.getRoot().filename() ?? "";
+                for (const node of nodes) {
+                    results.push({
+                        file,
+                        range: node.range(),
+                        text: node.text(),
+                    });
+                }
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({ results, errors: errors.map(String) }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                isError: true,
+                content: [{ type: "text", text: String(err) }],
+            };
+        }
+    });
+}

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.9",
+  "version": "0.1.11",
   "description": "MCP server with file operations (delete, move) and timing utilities.",
   "license": "MIT",
   "type": "module",
@@ -29,6 +29,7 @@
     "patch": "npm version patch"
   },
   "dependencies": {
+    "@ast-grep/napi": "^0.42.1",
     "@modelcontextprotocol/sdk": "1.29.0",
     "logpare": "^0.1.0",
     "zod": "^3.24.0"