kitewright-mcp 0.1.0

package/README.md

@@ -0,0 +1,47 @@
+# kitewright-mcp
+
+Run the [kitewright](https://github.com/kitewright/kitewright) browser-automation
+MCP server with **npx** — no build step, no cargo. A tiny launcher that resolves
+the prebuilt `kite` binary for your platform and starts it over stdio.
+
+## Use it
+
+**Claude Code**
+
+```bash
+claude mcp add kitewright -- npx -y kitewright-mcp
+```
+
+**Cursor / any MCP client** (`mcp.json`)
+
+```jsonc
+{
+  "mcpServers": {
+    "kitewright": {
+      "command": "npx",
+      "args": ["-y", "kitewright-mcp"]
+    }
+  }
+}
+```
+
+That's it — `npx kitewright-mcp` with no args starts a stdio MCP server. Pass
+flags through for other modes (e.g. `npx kitewright-mcp --http` for the HTTP
+transport).
+
+## How it works
+
+The prebuilt `kite` binary ships as an optional per-platform dependency
+(`@kitewright/mcp-darwin-arm64`, `-darwin-x64`, `-linux-x64-gnu`,
+`-win32-x64-msvc`) — npm installs only the one matching your OS/arch, the same
+pattern esbuild and napi use. The launcher `require.resolve`s it and execs it.
+
+- Override the binary with `KITE_BINARY=/path/to/kite` (local dev / custom build).
+- If no prebuilt package covers your platform, install from source:
+  `cargo install --git https://github.com/kitewright/kitewright kitewright`.
+
+## Config
+
+All kitewright env vars apply (`KITE_HEADLESS`, `KITE_IDLE_TIMEOUT_SECS`,
+`KITE_ALLOW_SECRET_FILES`, …) — see the main
+[README](https://github.com/kitewright/kitewright#readme).

package/bin.js

@@ -0,0 +1,53 @@
+#!/usr/bin/env node
+"use strict";
+// Launcher for the kitewright MCP server. Resolves the prebuilt `kite` binary
+// for this platform (shipped as an optional per-platform dependency, the same
+// pattern esbuild/napi use) and execs it, passing through all args. With no
+// args it defaults to `--stdio` so `npx kitewright-mcp` starts a stdio MCP
+// server — the form MCP clients (Claude Code, Cursor) launch.
+const { spawnSync } = require("node:child_process");
+
+// platform-arch -> optional dependency package that ships the binary
+const PKG_BY_TARGET = {
+  "darwin-arm64": "@kitewright/mcp-darwin-arm64",
+  "darwin-x64": "@kitewright/mcp-darwin-x64",
+  "linux-x64": "@kitewright/mcp-linux-x64-gnu",
+  "win32-x64": "@kitewright/mcp-win32-x64-msvc",
+};
+
+function resolveBinary() {
+  // Explicit override wins (local dev / custom builds).
+  if (process.env.KITE_BINARY) return process.env.KITE_BINARY;
+
+  const target = `${process.platform}-${process.arch}`;
+  const exe = process.platform === "win32" ? "kite.exe" : "kite";
+  const pkg = PKG_BY_TARGET[target];
+  if (pkg) {
+    try {
+      return require.resolve(`${pkg}/${exe}`);
+    } catch {
+      /* optional dep not installed for this platform — fall through */
+    }
+  }
+  // Last resort: a `kite` already on PATH (e.g. `cargo install`).
+  return exe;
+}
+
+const args = process.argv.slice(2);
+if (args.length === 0) args.push("--stdio");
+
+const bin = resolveBinary();
+const res = spawnSync(bin, args, { stdio: "inherit" });
+
+if (res.error) {
+  const target = `${process.platform}-${process.arch}`;
+  process.stderr.write(
+    `kitewright-mcp: could not launch the kite binary (${bin}): ${res.error.message}\n` +
+      (PKG_BY_TARGET[target]
+        ? `The prebuilt package for ${target} may have failed to install. `
+        : `No prebuilt binary is published for ${target}. `) +
+      `Set KITE_BINARY=/path/to/kite, or install it with \`cargo install --git https://github.com/kitewright/kitewright kitewright\`.\n`,
+  );
+  process.exit(1);
+}
+process.exit(res.status == null ? 1 : res.status);

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "kitewright-mcp",
+  "version": "0.1.0",
+  "description": "Kitewright browser-automation MCP server — run with npx, no build step. Backed by the Rust kite engine.",
+  "license": "MIT",
+  "repository": "github:kitewright/kitewright",
+  "bin": {
+    "kitewright-mcp": "bin.js"
+  },
+  "files": [
+    "bin.js"
+  ],
+  "optionalDependencies": {
+    "@kitewright/mcp-darwin-arm64": "0.1.0",
+    "@kitewright/mcp-darwin-x64": "0.1.0",
+    "@kitewright/mcp-linux-x64-gnu": "0.1.0",
+    "@kitewright/mcp-win32-x64-msvc": "0.1.0"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "browser",
+    "automation",
+    "playwright-alternative",
+    "kitewright"
+  ],
+  "engines": {
+    "node": ">=18"
+  }
+}