nomadic-mcp 0.2.0

package/README.md

@@ -0,0 +1,36 @@
+# nomadicml-mcp
+
+MCP server for NomadicML — use NomadicML's video analysis platform directly from Claude Code and Claude.ai. Upload videos, run analysis, search events, and manage your fleet, all through natural language.
+
+## Quickstart
+
+```bash
+# Register with Claude Code
+claude mcp add nomadicml \
+  -e NOMADICML_API_KEY=your_api_key \
+  -- npx nomadicml-mcp
+```
+
+Get your API key at [app.nomadicml.com](https://app.nomadicml.com) → **Profile** → **API Keys**.
+
+Then just talk to Claude:
+
+> Analyze this dashcam video for driving violations:
+> https://storage.example.com/clip.mp4
+
+> Find all near-miss events in my fleet_march folder
+
+> Upload /Users/me/videos/trip.mp4 and detect lane changes
+
+## Requirements
+
+- Claude Code or Claude.ai with MCP support
+- A NomadicML account and API key
+- No Python, no pip — the binary is self-contained
+
+To create an npm update, run - 
+
+git tag -d v0.2.0
+git push origin --delete v0.2.0
+git tag v0.2.0
+git push origin v0.2.0

package/bin/run.js

@@ -0,0 +1,52 @@
+#!/usr/bin/env node
+/**
+ * Entry point for nomadicml-mcp.
+ * Resolves the correct pre-compiled binary for the current platform,
+ * then spawns it — passing through all stdio so it works as an MCP server.
+ */
+
+const { spawnSync } = require("child_process");
+const path = require("path");
+const fs = require("fs");
+const os = require("os");
+
+function getPlatformKey() {
+  const p = process.platform;
+  const a = process.arch;
+  if (p === "darwin" && a === "arm64") return "darwin-arm64";
+  if (p === "darwin" && a === "x64")   return "darwin-x64";
+  if (p === "linux"  && a === "x64")   return "linux-x64";
+  if (p === "win32"  && a === "x64")   return "win32-x64";
+  throw new Error(
+    `Unsupported platform: ${p}/${a}. ` +
+    "Please open an issue at https://github.com/nomadic-ml/nomadicml-mcp"
+  );
+}
+
+function getBinaryPath() {
+  const key = getPlatformKey();
+  const ext = process.platform === "win32" ? ".exe" : "";
+  const binaryName = `nomadicml-mcp-${key}${ext}`;
+  const binaryPath = path.join(__dirname, "..", "bin", binaryName);
+
+  if (!fs.existsSync(binaryPath)) {
+    throw new Error(
+      `Binary not found: ${binaryPath}\n` +
+      "Try reinstalling: npx nomadicml-mcp@latest\n" +
+      "Or run: node scripts/install.js"
+    );
+  }
+  return binaryPath;
+}
+
+try {
+  const binary = getBinaryPath();
+  const result = spawnSync(binary, process.argv.slice(2), {
+    stdio: "inherit",
+    env: process.env,
+  });
+  process.exit(result.status ?? 1);
+} catch (err) {
+  console.error(`[nomadicml-mcp] ${err.message}`);
+  process.exit(1);
+}

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "nomadic-mcp",
+  "version": "0.2.0",
+  "description": "MCP server for NomadicML — full video analysis SDK for Claude Code and Claude.ai",
+  "keywords": ["mcp", "nomadicml", "video", "ai", "claude", "video-analysis"],
+  "homepage": "https://nomadicml.com",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/nomadic-ml/nomadicml-mcp"
+  },
+  "license": "MIT",
+  "bin": {
+    "nomadicml-mcp": "./bin/run.js"
+  },
+  "scripts": {
+    "postinstall": "node scripts/install.js"
+  },
+  "files": [
+    "bin/",
+    "scripts/",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  }
+}

package/scripts/install.js

@@ -0,0 +1,96 @@
+/**
+ * Runs after `npm install` (postinstall hook).
+ * Downloads the correct pre-compiled binary from GitHub Releases
+ * for the current platform and places it in bin/.
+ */
+
+const https = require("https");
+const fs = require("fs");
+const path = require("path");
+const os = require("os");
+const { execSync } = require("child_process");
+
+const PACKAGE_VERSION = require("../package.json").version;
+const GITHUB_REPO = "nomadic-ml/nomadic-mcp";
+const BIN_DIR = path.join(__dirname, "..", "bin");
+
+function getPlatformKey() {
+  const p = process.platform;
+  const a = process.arch;
+  if (p === "darwin" && a === "arm64") return "darwin-arm64";
+  if (p === "darwin" && a === "x64")   return "darwin-x64";
+  if (p === "linux"  && a === "x64")   return "linux-x64";
+  if (p === "win32"  && a === "x64")   return "win32-x64";
+  return null;
+}
+
+function getBinaryName(key) {
+  const ext = process.platform === "win32" ? ".exe" : "";
+  return `nomadicml-mcp-${key}${ext}`;
+}
+
+function download(url, dest) {
+  return new Promise((resolve, reject) => {
+    const file = fs.createWriteStream(dest);
+    const follow = (u) => {
+      https.get(u, (res) => {
+        if (res.statusCode === 301 || res.statusCode === 302) {
+          follow(res.headers.location);
+          return;
+        }
+        if (res.statusCode !== 200) {
+          reject(new Error(`HTTP ${res.statusCode} downloading ${u}`));
+          return;
+        }
+        res.pipe(file);
+        file.on("finish", () => file.close(resolve));
+        file.on("error", reject);
+      }).on("error", reject);
+    };
+    follow(url);
+  });
+}
+
+async function main() {
+  const key = getPlatformKey();
+  if (!key) {
+    console.warn(
+      `[nomadicml-mcp] Unsupported platform ${process.platform}/${process.arch} — skipping binary install.`
+    );
+    return;
+  }
+
+  const binaryName = getBinaryName(key);
+  const binaryPath = path.join(BIN_DIR, binaryName);
+
+  // Already installed
+  if (fs.existsSync(binaryPath)) {
+    console.log(`[nomadicml-mcp] Binary already installed: ${binaryName}`);
+    return;
+  }
+
+  fs.mkdirSync(BIN_DIR, { recursive: true });
+
+  const url = `https://github.com/${GITHUB_REPO}/releases/download/v${PACKAGE_VERSION}/${binaryName}`;
+  console.log(`[nomadicml-mcp] Downloading binary for ${key}...`);
+  console.log(`[nomadicml-mcp] ${url}`);
+
+  try {
+    await download(url, binaryPath);
+    // Make executable on Unix
+    if (process.platform !== "win32") {
+      fs.chmodSync(binaryPath, 0o755);
+    }
+    console.log(`[nomadicml-mcp] Installed: ${binaryName}`);
+  } catch (err) {
+    fs.unlink(binaryPath, () => {});
+    console.error(`[nomadicml-mcp] Failed to download binary: ${err.message}`);
+    console.error(
+      `[nomadicml-mcp] You can download it manually from:\n` +
+      `  https://github.com/${GITHUB_REPO}/releases/tag/v${PACKAGE_VERSION}`
+    );
+    process.exit(1);
+  }
+}
+
+main();