mcp-multitool 0.1.1 → 0.1.4

package/README.md

@@ -4,11 +4,23 @@
 [![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 with utility tools.
+A [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server with **file operations**, **log compression**, and **timing utilities**.
+
+## Tools
+
+| Tool                  | Description                                     |
+| --------------------- | ----------------------------------------------- |
+| `deleteFile`          | Delete files or directories (single or batch)   |
+| `moveFile`            | Move/rename files or directories                |
+| `compressLogs`        | Compress log arrays with 60-90% token reduction |
+| `compressText`        | Compress multi-line log text                    |
+| `analyzePatterns`     | Quick pattern extraction from logs              |
+| `estimateCompression` | Estimate compression ratio before processing    |
+| `wait`                | Pause execution for rate limits or timing       |
 
 ## Why
 
-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.
+Some tasks need simple utilities that don't warrant a larger server — cleaning up temp files, compressing verbose logs before analysis, pausing for rate limits. `mcp-multitool` gives any MCP-compatible client a small set of reliable tools.
 
 ## Quick Start
 
@@ -50,6 +62,72 @@ npx mcp-multitool
 
 ## Tool Reference
 
+### `analyzePatterns`
+
+Quick pattern analysis without full compression. Returns top N patterns found in logs, useful for rapid log triage.
+
+| Parameter     | Type       | Required | Default | Description                 |
+| ------------- | ---------- | -------- | ------- | --------------------------- |
+| `lines`       | `string[]` | ✅       | —       | Log lines to analyze.       |
+| `maxPatterns` | `integer`  | —        | `20`    | Maximum patterns to return. |
+
+**Response:** JSON object with `patterns` array and `total` line count.
+
+**Examples:**
+
+```
+analyzePatterns  lines=["INFO Starting server", "INFO Starting server", "ERROR Failed"]
+analyzePatterns  lines=[...logs]  maxPatterns=10
+```
+
+---
+
+### `compressLogs`
+
+Compress an array of log lines using semantic pattern extraction. Achieves 60-90% token reduction while preserving diagnostic context.
+
+| Parameter      | Type       | Required | Default   | Description                                                             |
+| -------------- | ---------- | -------- | --------- | ----------------------------------------------------------------------- |
+| `lines`        | `string[]` | ✅       | —         | Log lines to compress.                                                  |
+| `format`       | `string`   | —        | `summary` | Output format: `summary` (compact), `detailed` (full metadata), `json`. |
+| `depth`        | `integer`  | —        | `4`       | Parse tree depth for pattern matching (2-8).                            |
+| `simThreshold` | `number`   | —        | `0.4`     | Similarity threshold for template matching (0.0-1.0).                   |
+| `maxTemplates` | `integer`  | —        | `50`      | Maximum templates to include in output.                                 |
+
+**Response:** Compressed log summary showing unique templates and occurrence counts.
+
+**Examples:**
+
+```
+compressLogs  lines=["2026-04-07 INFO Starting on port 3000", "2026-04-07 INFO Starting on port 3001"]
+compressLogs  lines=[...logs]  format="json"  maxTemplates=20
+```
+
+---
+
+### `compressText`
+
+Compress a multi-line log text string. Automatically splits on newlines and processes as individual log lines.
+
+| Parameter      | Type      | Required | Default   | Description                                                             |
+| -------------- | --------- | -------- | --------- | ----------------------------------------------------------------------- |
+| `text`         | `string`  | ✅       | —         | Multi-line log text to compress.                                        |
+| `format`       | `string`  | —        | `summary` | Output format: `summary` (compact), `detailed` (full metadata), `json`. |
+| `depth`        | `integer` | —        | `4`       | Parse tree depth for pattern matching (2-8).                            |
+| `simThreshold` | `number`  | —        | `0.4`     | Similarity threshold for template matching (0.0-1.0).                   |
+| `maxTemplates` | `integer` | —        | `50`      | Maximum templates to include in output.                                 |
+
+**Response:** Compressed log summary showing unique templates and occurrence counts.
+
+**Examples:**
+
+```
+compressText  text="INFO Starting server\nINFO Starting server\nERROR Failed"
+compressText  text="<paste logs here>"  format="detailed"
+```
+
+---
+
 ### `deleteFile`
 
 Delete one or more files or directories.
@@ -71,6 +149,26 @@ deleteFile  paths="build/"  recursive=true
 
 ---
 
+### `estimateCompression`
+
+Estimate compression ratio without full processing. Samples a subset of logs to predict compression effectiveness.
+
+| Parameter    | Type       | Required | Default | Description                               |
+| ------------ | ---------- | -------- | ------- | ----------------------------------------- |
+| `lines`      | `string[]` | ✅       | —       | Log lines to sample.                      |
+| `sampleSize` | `integer`  | —        | `1000`  | Number of lines to sample for estimation. |
+
+**Response:** JSON object with estimated compression ratio, token reduction, and recommendation.
+
+**Examples:**
+
+```
+estimateCompression  lines=[...largeLogs]
+estimateCompression  lines=[...logs]  sampleSize=500
+```
+
+---
+
 ### `moveFile`
 
 Move one or more files or directories to a destination directory.
@@ -114,12 +212,16 @@ wait  durationMs=500   reason="animation to complete"
 
 ## Environment Variables
 
-| 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.                                                   |
+| Variable              | Default  | Description                                                                                               |
+| --------------------- | -------- | --------------------------------------------------------------------------------------------------------- |
+| `waitMaxDurationMs`   | `300000` | Override the maximum allowed `durationMs`. Must be a positive number. Server refuses to start if invalid. |
+| `analyzePatterns`     | _(on)_   | Set to `"false"` to disable the `analyzePatterns` tool at startup.                                        |
+| `compressLogs`        | _(on)_   | Set to `"false"` to disable the `compressLogs` tool at startup.                                           |
+| `compressText`        | _(on)_   | Set to `"false"` to disable the `compressText` tool at startup.                                           |
+| `deleteFile`          | _(on)_   | Set to `"false"` to disable the `deleteFile` tool at startup.                                             |
+| `estimateCompression` | _(on)_   | Set to `"false"` to disable the `estimateCompression` 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,13 +1,28 @@
 #!/usr/bin/env node
+import { createRequire } from "node:module";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { register as registerAnalyzePatterns } from "./tools/analyzePatterns.js";
+import { register as registerCompressLogs } from "./tools/compressLogs.js";
+import { register as registerCompressText } from "./tools/compressText.js";
 import { register as registerDeleteFile } from "./tools/deleteFile.js";
+import { register as registerEstimateCompression } from "./tools/estimateCompression.js";
 import { register as registerMoveFile } from "./tools/moveFile.js";
 import { register as registerWait } from "./tools/wait.js";
+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: "0.1.0" });
+const server = new McpServer({ name: "mcp-multitool", version });
+if (isEnabled("analyzePatterns"))
+    registerAnalyzePatterns(server);
+if (isEnabled("compressLogs"))
+    registerCompressLogs(server);
+if (isEnabled("compressText"))
+    registerCompressText(server);
 if (isEnabled("deleteFile"))
     registerDeleteFile(server);
+if (isEnabled("estimateCompression"))
+    registerEstimateCompression(server);
 if (isEnabled("moveFile"))
     registerMoveFile(server);
 if (isEnabled("wait"))

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

@@ -0,0 +1,47 @@
+import { compress } from "logpare";
+import { z } from "zod";
+const schema = z.object({
+    lines: z.array(z.string()).min(1).describe("Log lines to analyze."),
+    maxPatterns: z
+        .number()
+        .int()
+        .min(1)
+        .max(100)
+        .default(20)
+        .describe("Maximum patterns to return."),
+});
+export function register(server) {
+    server.registerTool("analyzePatterns", {
+        description: "Quick pattern analysis without full compression. Returns top N patterns " +
+            "found in logs, useful for rapid log triage.",
+        inputSchema: schema,
+        annotations: {
+            readOnlyHint: true,
+        },
+    }, async (input) => {
+        try {
+            const result = compress(input.lines, {
+                format: "json",
+                maxTemplates: input.maxPatterns,
+            });
+            const patterns = result.templates.map((t) => ({
+                pattern: t.pattern,
+                count: t.occurrences,
+                severity: t.severity,
+            }));
+            const output = {
+                patterns,
+                total: result.stats.inputLines,
+            };
+            return {
+                content: [{ type: "text", text: JSON.stringify(output, null, 2) }],
+            };
+        }
+        catch (err) {
+            return {
+                isError: true,
+                content: [{ type: "text", text: String(err) }],
+            };
+        }
+    });
+}

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

@@ -0,0 +1,60 @@
+import { compress } from "logpare";
+import { z } from "zod";
+const schema = z.object({
+    lines: z.array(z.string()).min(1).describe("Log lines to compress."),
+    format: z
+        .enum(["summary", "detailed", "json"])
+        .default("summary")
+        .describe("Output format: summary (compact), detailed (full metadata), json (machine-readable)."),
+    depth: z
+        .number()
+        .int()
+        .min(2)
+        .max(8)
+        .default(4)
+        .describe("Parse tree depth for pattern matching (2-8)."),
+    simThreshold: z
+        .number()
+        .min(0)
+        .max(1)
+        .default(0.4)
+        .describe("Similarity threshold for template matching (0.0-1.0)."),
+    maxTemplates: z
+        .number()
+        .int()
+        .min(1)
+        .max(500)
+        .default(50)
+        .describe("Maximum templates to include in output."),
+});
+export function register(server) {
+    server.registerTool("compressLogs", {
+        description: "Compress an array of log lines using semantic pattern extraction. " +
+            "Achieves 60-90% token reduction while preserving diagnostic context.",
+        inputSchema: schema,
+        annotations: {
+            readOnlyHint: true,
+        },
+    }, async (input) => {
+        try {
+            const options = {
+                format: input.format,
+                maxTemplates: input.maxTemplates,
+                drain: {
+                    depth: input.depth,
+                    simThreshold: input.simThreshold,
+                },
+            };
+            const result = compress(input.lines, options);
+            return {
+                content: [{ type: "text", text: result.formatted }],
+            };
+        }
+        catch (err) {
+            return {
+                isError: true,
+                content: [{ type: "text", text: String(err) }],
+            };
+        }
+    });
+}

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

@@ -0,0 +1,60 @@
+import { compressText as logpareCompressText, } from "logpare";
+import { z } from "zod";
+const schema = z.object({
+    text: z.string().min(1).describe("Multi-line log text to compress."),
+    format: z
+        .enum(["summary", "detailed", "json"])
+        .default("summary")
+        .describe("Output format: summary (compact), detailed (full metadata), json (machine-readable)."),
+    depth: z
+        .number()
+        .int()
+        .min(2)
+        .max(8)
+        .default(4)
+        .describe("Parse tree depth for pattern matching (2-8)."),
+    simThreshold: z
+        .number()
+        .min(0)
+        .max(1)
+        .default(0.4)
+        .describe("Similarity threshold for template matching (0.0-1.0)."),
+    maxTemplates: z
+        .number()
+        .int()
+        .min(1)
+        .max(500)
+        .default(50)
+        .describe("Maximum templates to include in output."),
+});
+export function register(server) {
+    server.registerTool("compressText", {
+        description: "Compress a multi-line log text string. Automatically splits on newlines " +
+            "and processes as individual log lines.",
+        inputSchema: schema,
+        annotations: {
+            readOnlyHint: true,
+        },
+    }, async (input) => {
+        try {
+            const options = {
+                format: input.format,
+                maxTemplates: input.maxTemplates,
+                drain: {
+                    depth: input.depth,
+                    simThreshold: input.simThreshold,
+                },
+            };
+            const result = logpareCompressText(input.text, options);
+            return {
+                content: [{ type: "text", text: result.formatted }],
+            };
+        }
+        catch (err) {
+            return {
+                isError: true,
+                content: [{ type: "text", text: String(err) }],
+            };
+        }
+    });
+}

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

@@ -0,0 +1,47 @@
+import { compress } from "logpare";
+import { z } from "zod";
+const schema = z.object({
+    lines: z.array(z.string()).min(1).describe("Log lines to sample."),
+    sampleSize: z
+        .number()
+        .int()
+        .min(100)
+        .max(10000)
+        .default(1000)
+        .describe("Number of lines to sample for estimation."),
+});
+export function register(server) {
+    server.registerTool("estimateCompression", {
+        description: "Estimate compression ratio without full processing. Samples a subset of " +
+            "logs to predict compression effectiveness.",
+        inputSchema: schema,
+        annotations: {
+            readOnlyHint: true,
+        },
+    }, async (input) => {
+        try {
+            const sampleSize = Math.min(input.sampleSize, input.lines.length);
+            const sample = input.lines.slice(0, sampleSize);
+            const result = compress(sample, { format: "json" });
+            const output = {
+                sampleSize,
+                totalLines: input.lines.length,
+                estimatedTemplates: Math.round(result.stats.uniqueTemplates * (input.lines.length / sampleSize)),
+                estimatedCompressionRatio: result.stats.compressionRatio,
+                estimatedTokenReduction: result.stats.estimatedTokenReduction,
+                recommendation: result.stats.compressionRatio > 0.5 ?
+                    "Good compression expected"
+                    : "Limited compression - logs may be highly variable",
+            };
+            return {
+                content: [{ type: "text", text: JSON.stringify(output, null, 2) }],
+            };
+        }
+        catch (err) {
+            return {
+                isError: true,
+                content: [{ type: "text", text: String(err) }],
+            };
+        }
+    });
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "mcp-multitool",
-  "version": "0.1.1",
-  "description": "Minimal MCP server — wait tool and more.",
+  "version": "0.1.4",
+  "description": "MCP server with file operations (delete, move), log compression (60-90% token reduction), and timing utilities.",
   "license": "MIT",
   "type": "module",
   "main": "dist/index.js",
@@ -14,7 +14,12 @@
   "keywords": [
     "mcp",
     "model-context-protocol",
+    "log-compression",
+    "file-operations",
+    "delete-file",
+    "move-file",
     "wait",
+    "logpare",
     "tool"
   ],
   "scripts": {
@@ -27,6 +32,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "1.29.0",
+    "logpare": "^0.1.0",
     "zod": "^3.24.0"
   },
   "devDependencies": {