mcp-multitool 0.1.8 → 0.1.10

package/README.md

@@ -10,6 +10,7 @@ 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 |
 | `deleteFileOrDir` | Delete one or more files or directories                 |
 | `moveFileOrDir`   | Move one or more files or directories to a new location |
@@ -61,6 +62,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.
@@ -215,6 +238,7 @@ 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.                                              |
 | `deleteFileOrDir`        | _(on)_  | Set to `"false"` to disable the `deleteFileOrDir` tool at startup.                                             |
 | `moveFileOrDir`          | _(on)_  | Set to `"false"` to disable the `moveFileOrDir` tool at startup.                                               |

package/dist/index.js

@@ -2,6 +2,7 @@
 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 registerDeleteFileOrDir } from "./tools/deleteFileOrDir.js";
 import { register as registerMoveFileOrDir } from "./tools/moveFileOrDir.js";
@@ -12,6 +13,8 @@ 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("deleteFileOrDir"))

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/readLogFile.js

@@ -117,7 +117,7 @@ function registerFlush(server) {
         flushTool = server.registerTool("flushLogFile", {
             description: "Release a log drain to free memory. Next readLogFile creates fresh drain.",
             inputSchema: flushSchema,
-            annotations: { destructiveHint: true, idempotentHint: true },
+            annotations: { destructiveHint: false, idempotentHint: true },
         }, async (input) => {
             try {
                 const path = resolve(process.cwd(), input.path);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-multitool",
-  "version": "0.1.8",
+  "version": "0.1.10",
   "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"