katana-markdown-linter 0.19.2 → 0.19.3

package/README.md

@@ -1,10 +1,10 @@
 # katana-markdown-linter
 
-`katana-markdown-linter` is a thin npm launcher for the `kml` Markdown linter.
-The package does not contain independent lint logic. On first use, it downloads
-the matching `kml` binary archive from GitHub Releases, verifies the neighboring
-SHA-256 checksum, installs the binary into the wrapper cache, and then delegates
-all commands to that binary, including localized CLI help.
+`katana-markdown-linter` is a thin launcher over GitHub Release binary
+archives for npm. The package does not contain independent lint or MCP server
+logic. On first use, it downloads the matching `kml`, `kml-mcp`, or `kml-mcp-remote`
+binary archive, verifies the neighboring SHA-256 checksum, installs the binary
+into the wrapper cache, and delegates to that binary.
 
 ## Install
 
@@ -16,8 +16,8 @@ kml --version
 Use `npx` for one-off runs:
 
 ~~~bash
-npx --yes katana-markdown-linter@0.18.0 --version
-npx --yes katana-markdown-linter@0.18.0 check README.md
+npx --yes katana-markdown-linter@0.19.3 --version
+npx --yes katana-markdown-linter@0.19.3 check README.md
 ~~~
 
 ## Basic Usage
@@ -45,6 +45,23 @@ kml fix README.md
 kml fmt
 ~~~
 
+## MCP server entrypoints
+
+Use `kml-mcp` for local stdio MCP clients:
+
+~~~bash
+npx --yes katana-markdown-linter@0.19.3 kml-mcp --workspace-root /absolute/path/to/workspace
+bunx --package katana-markdown-linter@0.19.3 kml-mcp --workspace-root /absolute/path/to/workspace
+npx --yes --package katana-markdown-linter@0.19.3 kml-mcp --workspace-root /absolute/path/to/workspace
+~~~
+
+Use `kml-mcp-remote` only for self-hosted Streamable HTTP:
+
+~~~bash
+KML_MCP_REMOTE_TOKEN=change-me \
+  npx --yes --package katana-markdown-linter@0.19.3 kml-mcp-remote
+~~~
+
 ## Supported Platforms
 
 The npm launcher uses the same binary archives as the GitHub Release channel.
@@ -60,12 +77,12 @@ Unsupported platforms fail before download with an explicit platform error.
 ## Wrapper Contract
 
 - The package version selects the GitHub Release tag.
-- The launcher downloads `kml-vX.Y.Z-<target>.tar.gz` or
-  `kml-vX.Y.Z-<target>.zip`.
+- The launcher downloads the matching `kml-vX.Y.Z-<target>`,
+  `kml-mcp-vX.Y.Z-<target>`, or `kml-mcp-remote-vX.Y.Z-<target>` archive.
 - The launcher downloads the matching `.sha256` file and verifies the archive
   before extraction.
-- The installed binary is cached under the package-local `vendor` directory by
-  default.
+- The installed binary is cached by version, platform, and executable role.
+- MCP launchers do not write wrapper logs to stdout, preserving JSON-RPC stdio.
 
 For full CLI usage, rule coverage, and other install channels, see the
 [repository README](https://github.com/HiroyukiFuruno/katana-markdown-linter).

package/bin/katana-markdown-linter.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+const { dispatchPackageCommand } = require("../lib/launcher");
+
+process.exit(dispatchPackageCommand(process.argv.slice(2)));

package/bin/kml-mcp-remote.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+const { KmlLauncher } = require("../lib/launcher");
+
+process.exit(new KmlLauncher("kml-mcp-remote", process.argv.slice(2)).run());

package/bin/kml-mcp.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+const { KmlLauncher } = require("../lib/launcher");
+
+process.exit(new KmlLauncher("kml-mcp", process.argv.slice(2)).run());

package/bin/kml.js

@@ -1,13 +1,4 @@
 #!/usr/bin/env node
-const { spawnSync } = require("node:child_process");
-const { KmlInstaller } = require("../lib/installer");
+const { KmlLauncher } = require("../lib/launcher");
 
-const installer = new KmlInstaller();
-const binaryPath = installer.ensureBinary();
-const result = spawnSync(binaryPath, process.argv.slice(2), { stdio: "inherit" });
-
-if (result.error) {
-  throw result.error;
-}
-
-process.exit(result.status === null ? 1 : result.status);
+process.exit(new KmlLauncher("kml", process.argv.slice(2)).run());

package/lib/installer.js

@@ -4,8 +4,18 @@ const fs = require("node:fs");
 const os = require("node:os");
 const path = require("node:path");
 
+const BINARY_ROLES = {
+  cli: { executable: "kml", archivePrefix: "kml" },
+  kml: { executable: "kml", archivePrefix: "kml" },
+  "kml-mcp": { executable: "kml-mcp", archivePrefix: "kml-mcp" },
+  mcp: { executable: "kml-mcp", archivePrefix: "kml-mcp" },
+  "kml-mcp-remote": { executable: "kml-mcp-remote", archivePrefix: "kml-mcp-remote" },
+  "mcp-remote": { executable: "kml-mcp-remote", archivePrefix: "kml-mcp-remote" }
+};
+
 class KmlInstaller {
-  constructor() {
+  constructor(binaryRole = "cli") {
+    this.role = this.resolveRole(binaryRole);
     this.packageRoot = path.resolve(__dirname, "..");
     this.packageJson = require(path.join(this.packageRoot, "package.json"));
     this.version = process.env.KML_WRAPPER_VERSION || `v${this.packageJson.version}`;
@@ -15,7 +25,14 @@ class KmlInstaller {
   }
 
   ensureBinary() {
-    const binaryPath = path.join(this.installRoot, this.version, this.target, "bin", this.binaryName());
+    const binaryPath = path.join(
+      this.installRoot,
+      this.version,
+      this.target,
+      this.role.executable,
+      "bin",
+      this.binaryName()
+    );
     if (fs.existsSync(binaryPath)) {
       return binaryPath;
     }
@@ -83,7 +100,15 @@ class KmlInstaller {
 
   resolveArchiveName() {
     const suffix = this.target.includes("windows") ? "zip" : "tar.gz";
-    return `kml-${this.version}-${this.target}.${suffix}`;
+    return `${this.role.archivePrefix}-${this.version}-${this.target}.${suffix}`;
+  }
+
+  resolveRole(binaryRole) {
+    const role = BINARY_ROLES[binaryRole];
+    if (!role) {
+      throw new Error(`Unsupported kml wrapper binary role: ${binaryRole}`);
+    }
+    return role;
   }
 
   resolveTarget() {
@@ -101,7 +126,7 @@ class KmlInstaller {
   }
 
   binaryName() {
-    return this.target.includes("windows") ? "kml.exe" : "kml";
+    return this.target.includes("windows") ? `${this.role.executable}.exe` : this.role.executable;
   }
 }
 

package/lib/launcher.js

@@ -0,0 +1,30 @@
+const { spawnSync } = require("node:child_process");
+const { KmlInstaller } = require("./installer");
+
+class KmlLauncher {
+  constructor(binaryRole, args) {
+    this.binaryRole = binaryRole;
+    this.args = args;
+  }
+
+  run() {
+    const installer = new KmlInstaller(this.binaryRole);
+    const binaryPath = installer.ensureBinary();
+    const result = spawnSync(binaryPath, this.args, { stdio: "inherit" });
+    if (result.error) {
+      throw result.error;
+    }
+    return result.status === null ? 1 : result.status;
+  }
+}
+
+function dispatchPackageCommand(args) {
+  const [firstArg, ...remainingArgs] = args;
+  const roles = new Set(["kml", "kml-mcp", "kml-mcp-remote"]);
+  if (roles.has(firstArg)) {
+    return new KmlLauncher(firstArg, remainingArgs).run();
+  }
+  return new KmlLauncher("kml", args).run();
+}
+
+module.exports = { KmlLauncher, dispatchPackageCommand };

package/package.json

@@ -1,13 +1,15 @@
 {
   "name": "katana-markdown-linter",
-  "version": "0.19.2",
+  "version": "0.19.3",
   "description": "Fast Markdown linter and formatter with localized CLI help and version aliases.",
   "keywords": [
     "markdown",
     "markdownlint",
     "linter",
     "kml",
-    "cli"
+    "cli",
+    "mcp",
+    "model-context-protocol"
   ],
   "homepage": "https://github.com/HiroyukiFuruno/katana-markdown-linter#readme",
   "bugs": {
@@ -19,7 +21,10 @@
     "url": "https://github.com/HiroyukiFuruno/katana-markdown-linter.git"
   },
   "bin": {
-    "kml": "bin/kml.js"
+    "katana-markdown-linter": "bin/katana-markdown-linter.js",
+    "kml": "bin/kml.js",
+    "kml-mcp": "bin/kml-mcp.js",
+    "kml-mcp-remote": "bin/kml-mcp-remote.js"
   },
   "scripts": {
     "postinstall": "node lib/installer.js"