@relay-core/mcp 0.3.7 → 0.3.10

package/README.md

@@ -1,41 +1,40 @@
 # @relay-core/mcp
 
-MCP (Model Context Protocol) server for [RelayCore](https://github.com/relaycraft/relay-core) — expose real-time traffic inspection and control to AI agents.
+[MCP](https://modelcontextprotocol.io) server for **[RelayCore](https://relaycore.dev)** — connect AI agents (Cursor, Claude Desktop, …) to live HTTP(S) traffic.
 
-## Quick Start
-
-### Cursor / Claude Desktop
+## Configure
 
 ```json
 {
   "mcpServers": {
     "relay-core": {
       "command": "npx",
-      "args": ["@relay-core/mcp"]
+      "args": ["-y", "@relay-core/mcp"]
     }
   }
 }
 ```
 
-Then ask your agent: "Search for recent 5xx errors and explain what went wrong."
+Requires **Node** ≥ 18. Binaries install via `@relay-core/binaries-*` (same as the CLI package).
 
-### Prerequisites
+## HTTPS prerequisite
 
-HTTPS interception requires a CA certificate trusted by your system:
+Install and trust the RelayCore CA once:
 
 ```bash
 npx @relay-core/cli ca init && npx @relay-core/cli ca install
 ```
 
-## Tools
+## Tools (overview)
+
+| Area | Examples |
+|------|----------|
+| Observe | `search_flows`, `get_flow`, `get_metrics` |
+| Control | `set_intercept`, `resume_flow`, `set_rule` |
+| Analyze | `export_har`, `replay_flow` |
+| Policy / scripts | `get_policy`, `set_script`, `mock_url` |
 
-| Category | Tools |
-|----------|-------|
-| Observe | `search_flows` `get_flow` `get_metrics` |
-| Control | `set_intercept` `resume_flow` `set_rule` `delete_rule` |
-| Analyze | `export_har` `replay_flow` |
-| Policy | `get_policy` `update_policy` `patch_policy` |
-| Extend | `set_script` `mock_url` |
+Details: [relaycore.dev](https://relaycore.dev) · [GitHub](https://github.com/relaycraft/relay-core)
 
 ## License
 

package/bin/mcp-probe

@@ -1,6 +1,16 @@
 #!/usr/bin/env node
+"use strict";
+
 const { spawnSync } = require("child_process");
-const path = require("path");
-const binary = process.platform === "win32" ? "relay-core-probe.exe" : "relay-core-probe";
-const result = spawnSync(path.join(__dirname, binary), process.argv.slice(2), { stdio: "inherit" });
+const { resolveBinary } = require("../lib/resolve-binary");
+
+let binary;
+try {
+  binary = resolveBinary("relay-core-probe");
+} catch (err) {
+  console.error(err.message);
+  process.exit(1);
+}
+
+const result = spawnSync(binary, process.argv.slice(2), { stdio: "inherit" });
 process.exit(result.status ?? 1);

package/lib/resolve-binary.js

@@ -0,0 +1,25 @@
+"use strict";
+
+/**
+ * Resolve a RelayCore native binary from the matching @relay-core/binaries-* optional dependency.
+ * @param {string} name - e.g. "relay-core-cli" or "relay-core-probe"
+ * @returns {string} Absolute path to the binary
+ */
+function resolveBinary(name) {
+  const platformPkg = `@relay-core/binaries-${process.platform}-${process.arch}`;
+  const file = process.platform === "win32" ? `${name}.exe` : name;
+  try {
+    return require.resolve(`${platformPkg}/bin/${file}`);
+  } catch (err) {
+    if (process.env.RELAY_CORE_DEBUG) {
+      console.error("[relay-core] resolveBinary:", err);
+    }
+    throw new Error(
+      `RelayCore native binary "${name}" is not installed for ${process.platform}-${process.arch}.\n` +
+        `Expected optional package ${platformPkg} (install or upgrade from the npm registry).\n` +
+        `Supported: macOS (x64, arm64), Linux (x64, arm64), Windows (x64). See https://relaycore.dev`
+    );
+  }
+}
+
+module.exports = { resolveBinary };

package/package.json

@@ -1,23 +1,36 @@
 {
   "name": "@relay-core/mcp",
-  "version": "0.3.7",
+  "version": "0.3.10",
   "description": "RelayCore MCP server — AI agent traffic control via Model Context Protocol",
   "license": "MIT",
+  "homepage": "https://relaycore.dev",
+  "bugs": "https://github.com/relaycraft/relay-core/issues",
   "repository": "github:relaycraft/relay-core",
   "bin": {
     "relay-core-probe": "./bin/mcp-probe"
   },
   "files": [
-    "install.js",
-    "README.md",
-    "bin/"
+    "bin/",
+    "lib/",
+    "README.md"
   ],
-  "scripts": {
-    "postinstall": "node install.js"
+  "optionalDependencies": {
+    "@relay-core/binaries-darwin-arm64": "0.3.10",
+    "@relay-core/binaries-darwin-x64": "0.3.10",
+    "@relay-core/binaries-linux-arm64": "0.3.10",
+    "@relay-core/binaries-linux-x64": "0.3.10",
+    "@relay-core/binaries-win32-x64": "0.3.10"
   },
   "engines": {
     "node": ">=18"
   },
-  "os": ["darwin", "linux", "win32"],
-  "cpu": ["x64", "arm64"]
+  "os": [
+    "darwin",
+    "linux",
+    "win32"
+  ],
+  "cpu": [
+    "x64",
+    "arm64"
+  ]
 }

package/install.js

@@ -1,89 +0,0 @@
-#!/usr/bin/env node
-"use strict";
-
-const { execSync } = require("child_process");
-const { existsSync, mkdirSync, readFileSync, createWriteStream } = require("fs");
-const { pipeline } = require("stream/promises");
-const { join } = require("path");
-const https = require("https");
-
-const PKG_DIR = join(__dirname, "..");
-const BINARY_NAME = "relay-core-probe";
-
-function getVersion() {
-  try {
-    return JSON.parse(readFileSync(join(PKG_DIR, "package.json"), "utf-8")).version;
-  } catch { return "0.3.0"; }
-}
-
-function getTarget() {
-  const map = {
-    "darwin-x64": "x86_64-apple-darwin",
-    "darwin-arm64": "aarch64-apple-darwin",
-    "linux-x64": "x86_64-unknown-linux-gnu",
-    "linux-arm64": "aarch64-unknown-linux-gnu",
-    "win32-x64": "x86_64-pc-windows-msvc",
-  };
-  const target = map[`${process.platform}-${process.arch}`];
-  if (!target) {
-    console.error(`Unsupported platform: ${process.platform}-${process.arch}. macOS/Linux/Windows (x64/arm64) supported.`);
-    process.exit(1);
-  }
-  return target;
-}
-
-async function download(url, dest) {
-  console.log(`Downloading ${url} → ${dest}`);
-  return new Promise((resolve, reject) => {
-    const file = createWriteStream(dest);
-    https.get(url, (response) => {
-      if (response.statusCode === 302 || response.statusCode === 301) {
-        https.get(response.headers.location, (rr) => pipeline(rr, file).then(resolve, reject));
-        return;
-      }
-      if (response.statusCode !== 200) return reject(new Error(`HTTP ${response.statusCode}`));
-      pipeline(response, file).then(resolve, reject);
-    }).on("error", reject);
-  });
-}
-
-(async () => {
-  try {
-    const binDir = join(PKG_DIR, "bin");
-    mkdirSync(binDir, { recursive: true });
-
-    const ext = process.platform === "win32" ? ".exe" : "";
-    const binaryPath = join(binDir, BINARY_NAME + ext);
-    const version = getVersion();
-
-    if (existsSync(binaryPath)) {
-      try {
-        const out = execSync(`"${binaryPath}" --version`, { encoding: "utf-8", timeout: 5000 }).trim();
-        if (out.includes(version)) {
-          console.log(`${BINARY_NAME} v${version} already installed.`);
-          return;
-        }
-        console.log(`Installed ${out}, updating to v${version}...`);
-      } catch { console.log("Re-downloading..."); }
-    }
-
-    const target = getTarget();
-    const archiveExt = process.platform === "win32" ? "zip" : "tar.gz";
-    const url = `https://github.com/relaycraft/relay-core/releases/download/v${version}/${BINARY_NAME}-${target}.${archiveExt}`;
-    const archivePath = join(binDir, `${BINARY_NAME}.${archiveExt}`);
-
-    await download(url, archivePath);
-    console.log("Extracting...");
-
-    if (process.platform === "win32") {
-      execSync(`powershell -Command "Expand-Archive -Path '${archivePath}' -DestinationPath '${binDir}' -Force"`, { stdio: "inherit" });
-    } else {
-      execSync(`tar xzf ${archivePath} -C ${binDir}`, { stdio: "inherit" });
-      execSync(`chmod +x ${binaryPath}`, { stdio: "inherit" });
-    }
-    console.log(`${BINARY_NAME} v${version} installed.`);
-  } catch (err) {
-    console.error("Install failed:", err.message);
-    process.exit(1);
-  }
-})();