whitemagic-mcp 9.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Lucas Bailey (WhiteMagic Labs)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,52 @@
+# whitemagic-mcp
+
+[WhiteMagic](https://whitemagic.dev) — local-first memory and session
+continuity for AI coding agents, over MCP. One static Rust binary, no
+telemetry, no cloud service. MIT.
+
+This package installs and runs the official `wm` binary from the
+[GitHub releases](https://github.com/lbailey94/whitemagic/releases)
+(checksum-verified at install time) so an MCP client can launch it
+without a manual download step.
+
+## Use
+
+Point any MCP client (Claude Desktop, Cursor, Codex, Gemini CLI,
+opencode) at:
+
+```json
+{
+  "mcpServers": {
+    "whitemagic": {
+      "command": "whitemagic-mcp",
+      "args": ["serve", "--profile", "curated"]
+    }
+  }
+}
+```
+
+Or try it directly:
+
+```bash
+npx whitemagic-mcp --version   # wm 9.0.0
+npx whitemagic-mcp doctor      # environment health check
+```
+
+The binary is cached under `~/.cache/whitemagic/bin/<release-tag>/`
+(respects `XDG_CACHE_HOME`); the package version's major tracks the
+release tag (9.0.0 → `v9`). Pin a different release with
+`WHITEMAGIC_RELEASE`.
+
+## Platforms
+
+Linux x86-64 (static musl), macOS arm64/x64, Windows x64. No asset for
+your platform? Build from source:
+https://github.com/lbailey94/whitemagic#install
+
+## Privacy
+
+Your memory store lives on your machine. `wm` does not phone home; this
+installer contacts GitHub releases only to download the binary and its
+checksum. See [PRIVACY_POLICY.md](https://github.com/lbailey94/whitemagic/blob/main/PRIVACY_POLICY.md).
+
+mcp-name: io.github.lbailey94/whitemagic-mcp

package/bin/cli.mjs

@@ -0,0 +1,80 @@
+#!/usr/bin/env node
+/**
+ * whitemagic-mcp — installs and runs the `wm` binary from the GitHub
+ * releases, with checksum verification. `npx whitemagic-mcp serve` is
+ * the MCP entrypoint. No dependencies; Node 18+ global fetch.
+ *
+ * Version contract: package major tracks the release tag (9.0.0 → v9).
+ * Override the tag with WHITEMAGIC_RELEASE (e.g. "v9").
+ */
+import { createHash } from "node:crypto";
+import { chmodSync, existsSync, mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { homedir, platform, arch, tmpdir } from "node:os";
+import { join } from "node:path";
+import { spawnSync } from "node:child_process";
+
+const pkg = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8"));
+const TAG = process.env.WHITEMAGIC_RELEASE ?? `v${pkg.version.split(".")[0]}`;
+const REPO = "lbailey94/whitemagic";
+const BASE = `https://github.com/${REPO}/releases/download/${TAG}`;
+
+function assetFor() {
+  const p = platform(), a = arch();
+  if (p === "linux" && a === "x64") return "wm-linux-x86_64-musl";
+  if (p === "darwin" && a === "arm64") return "wm-macos-aarch64";
+  if (p === "darwin" && a === "x64") return "wm-macos-x86_64";
+  if (p === "win32" && a === "x64") return "wm-windows-x86_64.exe";
+  return null;
+}
+
+async function fetchTo(url, dest) {
+  const res = await fetch(url, { redirect: "follow" });
+  if (!res.ok) throw new Error(`HTTP ${res.status} for ${url}`);
+  writeFileSync(dest, Buffer.from(await res.arrayBuffer()));
+}
+
+async function ensureBinary() {
+  const asset = assetFor();
+  if (!asset) {
+    console.error(`whitemagic-mcp: no release asset for ${platform()}/${arch()} yet.`);
+    console.error(`Install from source instead: https://github.com/${REPO}#install`);
+    process.exit(1);
+  }
+  const cached = join(
+    process.env.XDG_CACHE_HOME ?? join(homedir(), ".cache"),
+    "whitemagic",
+    "bin",
+    TAG,
+    asset,
+  );
+  if (existsSync(cached)) return cached;
+
+  console.error(`whitemagic-mcp: fetching ${TAG}/${asset} ...`);
+  const binDir = join(
+    process.env.XDG_CACHE_HOME ?? join(homedir(), ".cache"),
+    "whitemagic",
+    "bin",
+    TAG,
+  );
+  mkdirSync(binDir, { recursive: true });
+  const tmp = mkdtempSync(join(tmpdir(), "wm-dl-"));
+  try {
+    await fetchTo(`${BASE}/${asset}`, join(tmp, asset));
+    await fetchTo(`${BASE}/${asset}.sha256`, join(tmp, `${asset}.sha256`));
+    const expected = readFileSync(join(tmp, `${asset}.sha256`), "utf8").trim().split(/\s+/)[0];
+    const actual = createHash("sha256").update(readFileSync(join(tmp, asset))).digest("hex");
+    if (expected !== actual) {
+      throw new Error(`checksum mismatch for ${asset}\n  expected ${expected}\n  actual   ${actual}`);
+    }
+    writeFileSync(cached, readFileSync(join(tmp, asset)));
+    chmodSync(cached, 0o755);
+    return cached;
+  } finally {
+    rmSync(tmp, { recursive: true, force: true });
+  }
+}
+
+const bin = await ensureBinary();
+const isWin = platform() === "win32";
+const result = spawnSync(bin, process.argv.slice(2), { stdio: "inherit", shell: isWin });
+process.exit(result.status ?? 1);

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "whitemagic-mcp",
+  "version": "9.0.0",
+  "description": "WhiteMagic MCP server — local-first memory and session continuity for AI coding agents. Installs and runs the wm binary; no telemetry, no cloud.",
+  "license": "MIT",
+  "bin": {
+    "whitemagic-mcp": "./bin/cli.mjs"
+  },
+  "files": [
+    "bin/",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "mcp",
+    "mcp-server",
+    "agent-memory",
+    "ai-agents",
+    "local-first",
+    "whitemagic",
+    "session-continuity"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/lbailey94/whitemagic.git",
+    "directory": "npm/whitemagic-mcp"
+  },
+  "homepage": "https://whitemagic.dev",
+  "bugs": "https://github.com/lbailey94/whitemagic/issues",
+  "mcpName": "io.github.lbailey94/whitemagic-mcp"
+}