@krowk/mcp 0.1.1

package/README.md

@@ -0,0 +1,50 @@
+# @krowk/mcp
+
+The krowk MCP server. It gives an agent `krowk_push`, `krowk_list_artifacts`,
+`krowk_get_artifact`, `krowk_claim_artifact`, `krowk_get_run` and
+`krowk_verify_key` over stdio, so output from a task becomes a permalink without
+anybody shelling out.
+
+```json
+{
+  "mcpServers": {
+    "krowk": {
+      "command": "npx",
+      "args": ["-y", "@krowk/mcp"],
+      "env": { "KROWK_TOKEN": "krowk_sk_..." }
+    }
+  }
+}
+```
+
+Uploads are confined to a root directory — the working directory by default,
+`--root` or `KROWK_MCP_ROOT` to say otherwise. The model picks the paths, so the
+boundary is what keeps an instruction hidden in a repository file from
+publishing something else entirely.
+
+## What this package is
+
+A launcher. The server itself is a single static Go binary, `krowk-mcp`.
+Installing this package pulls one more package — `@krowk/cli-linux-x64` or
+whichever matches your machine — through the same npm registry as everything
+else. The platform packages carry both binaries, which is why the one this
+server needs is named for the CLI. There
+is no postinstall script and no download from a second host, so it works behind
+a proxy, under `npm ci --ignore-scripts`, and off a private mirror.
+
+If Node is not already in the picture, point the client at the binary instead:
+
+```bash
+go install github.com/krowkcom/cli/cmd/krowk-mcp@latest
+# or grab an archive from https://github.com/krowkcom/cli/releases/latest
+```
+
+```json
+{ "mcpServers": { "krowk": { "command": "krowk-mcp" } } }
+```
+
+## Documentation
+
+Tools, arguments, and the errors they return: <https://github.com/krowkcom/cli>.
+
+MIT.

package/bin/krowk-mcp.js

@@ -0,0 +1,104 @@
+#!/usr/bin/env node
+// Find the binary npm installed for this platform, then become it.
+//
+// The binary arrives as an optional dependency, not as a postinstall download,
+// so the only host an install talks to is the npm registry the machine is
+// already pointed at. That is what makes this work behind a proxy, under
+// `npm ci --ignore-scripts`, and off a private mirror.
+//
+// MCP speaks over stdio, so the passthrough below has to be exactly that:
+// inherited file descriptors, nothing in this process reading or writing them.
+//
+// This file is duplicated in npm/krowk/bin/krowk.js. Two published packages each
+// have to stand alone, and a shared module would mean a third package or a
+// codegen step to save sixty lines. npm/build.mjs checks both copies name the
+// same platforms, which is the drift that would actually bite.
+"use strict";
+
+const { spawnSync } = require("node:child_process");
+const path = require("node:path");
+
+// Keyed by `${process.platform}-${process.arch}`, so the lookup is the identity.
+const PACKAGES = {
+  "darwin-arm64": "@krowk/cli-darwin-arm64",
+  "darwin-x64": "@krowk/cli-darwin-x64",
+  "linux-arm64": "@krowk/cli-linux-arm64",
+  "linux-x64": "@krowk/cli-linux-x64",
+  "win32-x64": "@krowk/cli-win32-x64",
+};
+
+const BINARY = "krowk-mcp";
+
+// fail prints the reason and the next action, then stops. Nothing readable
+// reaches an MCP client from here — stdout is the protocol — so the whole
+// explanation goes to stderr, where the client logs it.
+function fail(lines) {
+  process.stderr.write(BINARY + ": " + lines.join("\n") + "\n");
+  process.exit(1);
+}
+
+function locate() {
+  const host = process.platform + "-" + process.arch;
+  const pkg = PACKAGES[host];
+
+  if (!pkg) {
+    fail([
+      "no prebuilt binary for " + host + ".",
+      "",
+      "Built for: " + Object.keys(PACKAGES).sort().join(", ") + ".",
+      "Everywhere else, build it yourself — the server is pure Go:",
+      "",
+      "  go install github.com/krowkcom/cli/cmd/krowk-mcp@latest",
+    ]);
+  }
+
+  let manifest;
+  try {
+    manifest = require.resolve(pkg + "/package.json");
+  } catch {
+    fail([
+      pkg + " is not installed, so there is no " + BINARY + " binary to run.",
+      "",
+      "It is an optional dependency, and installers skip those under",
+      "--no-optional, --omit=optional and --ignore-optional. A lockfile",
+      "written on another platform does the same thing.",
+      "",
+      "  npm install @krowk/mcp --include=optional",
+      "",
+      "Or take the binary straight from the release, no Node involved:",
+      "",
+      "  https://github.com/krowkcom/cli/releases/latest",
+    ]);
+  }
+
+  return path.join(
+    path.dirname(manifest),
+    "bin",
+    BINARY + (process.platform === "win32" ? ".exe" : ""),
+  );
+}
+
+const binary = locate();
+
+// stdio: "inherit" hands the child the real file descriptors, so the MCP client
+// on the other end is talking to the Go server directly.
+const result = spawnSync(binary, process.argv.slice(2), { stdio: "inherit" });
+
+if (result.error) {
+  fail([
+    "could not run " + binary + ": " + result.error.message,
+    "",
+    "The file is there but would not start. On a shared volume or an",
+    "extracted archive that usually means the execute bit was lost:",
+    "",
+    "  chmod +x " + binary,
+  ]);
+}
+
+// Re-raise the signal that killed the child, so `krowk-mcp` dies the way the
+// binary did and a client waiting on the exit status reads the same thing.
+if (result.signal) {
+  process.kill(process.pid, result.signal);
+}
+
+process.exit(result.status === null ? 1 : result.status);

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@krowk/mcp",
+  "version": "0.1.1",
+  "description": "MCP server for krowk — permalinks for agent output, over stdio.",
+  "keywords": [
+    "krowk",
+    "mcp",
+    "model-context-protocol",
+    "screenshot",
+    "permalink",
+    "agent"
+  ],
+  "homepage": "https://krowk.com",
+  "bugs": "https://github.com/krowkcom/cli/issues",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/krowkcom/cli.git",
+    "directory": "npm/mcp"
+  },
+  "license": "MIT",
+  "bin": {
+    "krowk-mcp": "bin/krowk-mcp.js"
+  },
+  "files": [
+    "bin"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "optionalDependencies": {
+    "@krowk/cli-darwin-arm64": "0.1.1",
+    "@krowk/cli-darwin-x64": "0.1.1",
+    "@krowk/cli-linux-arm64": "0.1.1",
+    "@krowk/cli-linux-x64": "0.1.1",
+    "@krowk/cli-win32-x64": "0.1.1"
+  }
+}