webtool-log-cleaner-mcp 1.0.0

package/README.md

@@ -0,0 +1,76 @@
+# webtool-log-cleaner
+
+A Python MCP server that captures raw logs from clipboard, files, shell commands, Docker, and Docker Compose, then deduplicates and compresses noisy output for AI debugging sessions.
+
+## Tools
+
+- `clean_clipboard_logs`
+- `clean_log_file`
+- `clean_command_logs`
+- `clean_docker_logs`
+- `clean_compose_logs`
+
+## Reliability guardrails
+
+- Default timeout: 30 seconds
+- Output capture cap: 8 MB
+- Max processed lines: 50,000
+- Timed out/truncated captures are returned as partial cleaned summaries with explicit notes
+
+## Installation
+
+### 1) PyPI + pipx (recommended)
+
+```bash
+pipx install webtool-log-cleaner
+```
+
+MCP config:
+
+```json
+{
+  "command": "webtool-log-cleaner",
+  "args": []
+}
+```
+
+### 2) Plain pip (no pipx required)
+
+```bash
+python3 -m pip install --user webtool-log-cleaner
+```
+
+MCP config:
+
+```json
+{
+  "command": "python3",
+  "args": ["-m", "webtool_log_cleaner.server"]
+}
+```
+
+### 3) npx wrapper
+
+```bash
+npx -y webtool-log-cleaner-mcp
+```
+
+MCP config:
+
+```json
+{
+  "command": "npx",
+  "args": ["-y", "webtool-log-cleaner-mcp"]
+}
+```
+
+Notes:
+- The npm wrapper still needs Python 3.11+ installed.
+- On first run, it bootstraps the Python package with `pip --user` if missing.
+
+## Local development
+
+```bash
+uv run pytest -q
+uv run webtool-log-cleaner
+```

package/bin/webtool-log-cleaner-mcp.cjs

@@ -0,0 +1,171 @@
+#!/usr/bin/env node
+
+const { spawn, spawnSync } = require("node:child_process");
+const fs = require("node:fs");
+const path = require("node:path");
+
+const PYTHON_PACKAGE = "webtool-log-cleaner";
+const MODULE_ENTRYPOINT = "webtool_log_cleaner.server";
+const args = process.argv.slice(2);
+
+function fail(message, code = 1) {
+  console.error(`[webtool-log-cleaner-mcp] ${message}`);
+  process.exit(code);
+}
+
+function runSync(command, commandArgs, options = {}) {
+  return spawnSync(command, commandArgs, {
+    stdio: "inherit",
+    ...options,
+  });
+}
+
+function resolveLocalSourcePath() {
+  const candidate = path.resolve(__dirname, "..", "src");
+  const packagePath = path.join(candidate, "webtool_log_cleaner");
+  if (fs.existsSync(packagePath)) {
+    return candidate;
+  }
+  return null;
+}
+
+function resolveLocalVenvPython() {
+  const venvPath = process.platform === "win32"
+    ? path.resolve(__dirname, "..", ".venv", "Scripts", "python.exe")
+    : path.resolve(__dirname, "..", ".venv", "bin", "python");
+  return fs.existsSync(venvPath) ? venvPath : null;
+}
+
+function withLocalPythonPath(localSrcPath) {
+  const delimiter = process.platform === "win32" ? ";" : ":";
+  const existing = process.env.PYTHONPATH;
+  return existing ? `${localSrcPath}${delimiter}${existing}` : localSrcPath;
+}
+
+function selectPython() {
+  const localVenvPython = resolveLocalVenvPython();
+  const candidates = process.platform === "win32"
+    ? [
+        ...(localVenvPython ? [{ command: localVenvPython, baseArgs: [] }] : []),
+        { command: "py", baseArgs: ["-3"] },
+        { command: "python", baseArgs: [] },
+        { command: "python3", baseArgs: [] },
+      ]
+    : [
+        ...(localVenvPython ? [{ command: localVenvPython, baseArgs: [] }] : []),
+        { command: "python3", baseArgs: [] },
+        { command: "python", baseArgs: [] },
+      ];
+
+  for (const candidate of candidates) {
+    const probe = spawnSync(candidate.command, [...candidate.baseArgs, "--version"], {
+      stdio: "ignore",
+    });
+    if (probe.status === 0) {
+      return candidate;
+    }
+  }
+
+  return null;
+}
+
+function ensurePythonPackageInstalled(python) {
+  const importProbe = spawnSync(
+    python.command,
+    [...python.baseArgs, "-c", `import ${MODULE_ENTRYPOINT.split(".")[0]}`],
+    { stdio: "ignore" }
+  );
+
+  if (importProbe.status === 0) {
+    return null;
+  }
+
+  const localSourcePath = resolveLocalSourcePath();
+  if (localSourcePath) {
+    const localProbe = spawnSync(
+      python.command,
+      [...python.baseArgs, "-c", `import ${MODULE_ENTRYPOINT.split(".")[0]}`],
+      {
+        stdio: "ignore",
+        env: {
+          ...process.env,
+          PYTHONPATH: withLocalPythonPath(localSourcePath),
+        },
+      }
+    );
+
+    if (localProbe.status === 0) {
+      return {
+        PYTHONPATH: withLocalPythonPath(localSourcePath),
+      };
+    }
+  }
+
+  console.error(`[webtool-log-cleaner-mcp] Installing ${PYTHON_PACKAGE} with pip --user...`);
+  const install = runSync(python.command, [
+    ...python.baseArgs,
+    "-m",
+    "pip",
+    "install",
+    "--user",
+    "--upgrade",
+    PYTHON_PACKAGE,
+  ], {
+    env: {
+      ...process.env,
+      PIP_REQUIRE_VIRTUALENV: "0",
+    },
+  });
+
+  if (install.status !== 0) {
+    fail(
+      "Could not install Python package. Install manually with `pipx install webtool-log-cleaner` or `python3 -m pip install --user webtool-log-cleaner`."
+    );
+  }
+
+  return null;
+}
+
+function launchServer(python, forwardedArgs, envOverrides) {
+  const child = spawn(
+    python.command,
+    [...python.baseArgs, "-m", MODULE_ENTRYPOINT, ...forwardedArgs],
+    {
+      stdio: "inherit",
+      env: {
+        ...process.env,
+        ...(envOverrides || {}),
+      },
+    }
+  );
+
+  child.on("error", (err) => {
+    fail(`Failed to start Python MCP server: ${err.message}`);
+  });
+
+  child.on("exit", (code, signal) => {
+    if (signal) {
+      process.kill(process.pid, signal);
+      return;
+    }
+    process.exit(code ?? 1);
+  });
+}
+
+function main() {
+  const python = selectPython();
+  if (!python) {
+    fail("Python 3.11+ is required but was not found in PATH.");
+  }
+
+  const envOverrides = ensurePythonPackageInstalled(python);
+
+  if (args.includes("--bootstrap-check")) {
+    console.log("webtool-log-cleaner-mcp bootstrap check: OK");
+    process.exit(0);
+  }
+
+  launchServer(python, args, envOverrides);
+}
+
+main();

package/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "webtool-log-cleaner-mcp",
+  "version": "1.0.0",
+  "description": "npx launcher for the Python webtool-log-cleaner MCP server",
+  "bin": {
+    "webtool-log-cleaner-mcp": "bin/webtool-log-cleaner-mcp.cjs"
+  },
+  "files": [
+    "bin/webtool-log-cleaner-mcp.cjs",
+    "README.md"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  }
+}