@relay-core/mcp 0.3.0 → 0.3.2

package/README.md

@@ -0,0 +1,42 @@
+# @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.
+
+## Quick Start
+
+### Cursor / Claude Desktop
+
+```json
+{
+  "mcpServers": {
+    "relay-core": {
+      "command": "npx",
+      "args": ["@relay-core/mcp"]
+    }
+  }
+}
+```
+
+Then ask your agent: "Search for recent 5xx errors and explain what went wrong."
+
+### Prerequisites
+
+HTTPS interception requires a CA certificate trusted by your system:
+
+```bash
+npx @relay-core/cli ca init && npx @relay-core/cli ca install
+```
+
+## Tools
+
+| 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` |
+
+## License
+
+MIT

package/install.js

@@ -1,13 +1,22 @@
 #!/usr/bin/env node
 const { execSync } = require("child_process");
-const { existsSync, mkdirSync } = require("fs");
+const { existsSync, mkdirSync, readFileSync } = require("fs");
 const { createWriteStream } = require("fs");
 const { pipeline } = require("stream/promises");
 const { join } = require("path");
 const https = require("https");
 
+const getVersion = () => {
+  try {
+    const pkg = JSON.parse(readFileSync(join(__dirname, "package.json"), "utf-8"));
+    return pkg.version;
+  } catch {
+    return "0.3.0";
+  }
+};
+
 const PACKAGE = process.env.npm_package_name || "@relay-core/cli";
-const VERSION = process.env.npm_package_version || "0.2.0";
+const VERSION = getVersion();
 
 // Map (os, arch) → GitHub release target
 function getTarget() {
@@ -17,11 +26,12 @@ function getTarget() {
     "darwin-x64": "x86_64-apple-darwin",
     "darwin-arm64": "aarch64-apple-darwin",
     "linux-x64": "x86_64-unknown-linux-gnu",
+    "win32-x64": "x86_64-pc-windows-msvc",
   };
   const key = `${os}-${arch}`;
   const target = map[key];
   if (!target) {
-    console.error(`Unsupported platform: ${key}. RelayCore currently supports macOS (Intel/Apple Silicon) and Linux (x86_64).`);
+    console.error(`Unsupported platform: ${key}. Supported: macOS (x64/arm64), Linux (x64), Windows (x64).`);
     process.exit(1);
   }
   return target;
@@ -31,6 +41,12 @@ function getBinaryName() {
   return PACKAGE.endsWith("mcp") ? "relay-core-probe" : "relay-core-cli";
 }
 
+function getBinaryPath(binaryName) {
+  return process.platform === "win32"
+    ? join(__dirname, "bin", binaryName + ".exe")
+    : join(__dirname, "bin", binaryName);
+}
+
 async function download(url, dest) {
   console.log(`Downloading ${url} → ${dest}`);
   return new Promise((resolve, reject) => {
@@ -54,8 +70,9 @@ async function download(url, dest) {
 (async () => {
   try {
     const binDir = join(__dirname, "bin");
+    mkdirSync(binDir, { recursive: true });
     const binaryName = getBinaryName();
-    const binaryPath = join(binDir, binaryName);
+    const binaryPath = getBinaryPath(binaryName);
 
     // Skip download if binary already exists (re-install)
     if (existsSync(binaryPath)) {
@@ -64,17 +81,17 @@ async function download(url, dest) {
     }
 
     const target = getTarget();
-    const url = `https://github.com/relaycraft/relay-core/releases/download/v${VERSION}/${binaryName}-${target}.tar.gz`;
-    const archivePath = join(binDir, `${binaryName}.tar.gz`);
+    const ext = process.platform === "win32" ? "zip" : "tar.gz";
+    const url = `https://github.com/relaycraft/relay-core/releases/download/v${VERSION}/${binaryName}-${target}.${ext}`;
+    const archivePath = join(binDir, `${binaryName}.${ext}`);
 
-    mkdirSync(binDir, { recursive: true });
     await download(url, archivePath);
 
     console.log("Extracting...");
-    execSync(`tar xzf ${archivePath} -C ${binDir}`, { stdio: "inherit" });
-
-    // Make executable
-    if (process.platform !== "win32") {
+    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" });
     }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@relay-core/mcp",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "RelayCore MCP server — AI agent traffic control via Model Context Protocol",
   "license": "MIT",
   "repository": "github:relaycraft/relay-core",
@@ -9,6 +9,7 @@
   },
   "files": [
     "install.js",
+    "README.md",
     "bin/"
   ],
   "scripts": {
@@ -17,6 +18,6 @@
   "engines": {
     "node": ">=18"
   },
-  "os": ["darwin", "linux"],
+  "os": ["darwin", "linux", "win32"],
   "cpu": ["x64", "arm64"]
 }